MineContext

主动捕捉上下文,让 AI 更懂你的每一次对话

开源 🏷️定价信息待确认 🔧 仅开源项目,无在线服务,需自行部署 搜索知识 🍴 复刻 413 🐛 待处理 135 👀 关注 22
GitHub ↗
GitHub 星标 ★ 5543
维护状态 低维护
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

MineContext 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类搜索知识
开发团队volcengine
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议Apache-2.0
主要语言Python
技术栈/模型agent,context-engineering,electron,embedding-models,javascript,memory,proactive-ai,python,python3,rag,react,typescript,vector-database,vision-language-model
GitHub 星标★ 5543
上线时间2025-06-24 00:00:00
代码更新2026-05-07
仓库体积28.8 MB
本站数据更新2026-11-07
维护状态低维护
收录时间2026-08-09
浏览次数4

项目介绍

MineContext 是一个主动式的上下文感知 AI 助手,基于 Context-Engineering 理念构建,结合 ChatGPT Pulse 技术,旨在解决 AI 对话中上下文丢失、信息碎片化的问题。它能够自动捕捉、整理并持续追踪用户的工作上下文,在需要时主动提供相关信息,让 AI 更懂用户。核心能力包括:实时上下文捕获、智能信息聚合、主动式提醒与建议、以及与主流 AI 工具的集成。项目采用 Python 开发,提供简单易用的 API 和插件系统,适合个人知识管理和团队协作场景。通过持续学习用户行为模式,MineContext 能逐步构建个性化知识图谱,提升 AI 交互的准确性和效率。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 5543

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:进阶 约 15 分钟 部署方式:本地安装 6 步

环境要求

  • Python 环境,后端推荐使用 uv 管理依赖
  • Node.js 与 pnpm(用于安装前端依赖)
  • 豆包(doubao)或 OpenAI 的 embedding、VLM 模型 API Key
  • macOS 或 Windows 桌面环境(客户端发布包)

安装与启动步骤

  1. 1下载安装客户端

    从 GitHub Releases 页面下载对应系统安装包:Mac 为 dmg,Windows 为 setup.exe,直接安装即可。

  2. 2安装 uv 工具

    后端推荐用 uv 做包管理,执行脚本安装;已安装过可跳过此步。

    curl -LsSf https://astral.sh/uv/install.sh | sh
  3. 3还原默认 PyPI 源

    因包版本问题不支持国内 PyPI 镜像,需先取消全局 index-url 配置。

    pip config unset global.index-url
  4. 4安装前端依赖

    进入 frontend 目录后执行 pnpm install 安装前端依赖包。

    cd frontend
    pnpm install
  5. 5填写配置文件

    编辑 config/config.yaml,填入 embedding_model 与 vlm_model 的 api_key,按需调整采集参数。

  6. 6启动后端服务

    用默认配置启动服务,启动前请确认配置文件中的 api_key 已替换为真实值。

    uv run opencontext start

关键配置

配置项必填说明示例
server.host否后端服务监听地址127.0.0.1
server.port否后端服务监听端口8765
embedding_model.provider是嵌入模型提供方,可选 openai 或 doubaodoubao
embedding_model.api_key是嵌入模型调用密钥your-api-key
embedding_model.model是使用的嵌入模型名称doubao-embedding-vision-250615
vlm_model.model是视觉语言模型名称doubao-seed-1-6-flash-250828

如何确认成功

后端启动后监听配置的 127.0.0.1:8765 且终端无报错;桌面客户端可正常打开。

常见问题

Q:Mac 提示应用被隔离或已损坏怎么办?

A:v0.1.5 起已支持 Apple 公证,无需再手动关闭 quarantine 属性;旧版本请参考 0.1.4 版本的旧文档处理。

Q:可以使用国内 PyPI 镜像加速吗?

A:不支持。README 明确说明因包版本问题需使用原始 PyPI 源,可执行 pip config unset global.index-url 还原配置。

Q:如何切换中英文提示词?

A:项目提供 config/prompts_zh.yaml 与 config/prompts_en.yaml 两套模板,按需选用中文或英文提示词模板。

Q:后端一定要用 uv 安装吗?

A:README 推荐使用 uv 进行快速可靠的包管理,因此启动命令为 uv run opencontext start。

注意事项

  • README 中未给出前端页面的启动命令,装好依赖后请以官方后续说明为准。
  • API Key 属于敏感信息,请勿将配置文件提交到公开仓库。
  • 桌面客户端发布包目前只提供 Mac(dmg)与 Windows(exe)两种。
  • 按需开启 capture.screenshot 截屏采集,采集间隔默认 5 秒,注意隐私保护。

核心亮点

  • 自动捕获并整理对话上下文,减少重复输入,提升交互效率
  • 基于 Context-Engineering 理念,实现主动式信息推送而非被动响应
  • 提供插件系统,可无缝集成到现有 AI 工作流中

不足之处

  • 文档/社区待观察
  • 依赖外部 AI 服务,可能增加使用成本

适用场景

  • 个人知识管理,自动归档日常对话和笔记
  • 团队协作时,共享上下文减少沟通成本
  • 开发者构建上下文感知的 AI 应用

替代项目

Mem0、Zep、Letta

上一篇:pyspur

下一篇:solace-agent-mesh

同类项目推荐

superagentx 开源

策略驱动,统一管控,让AI智能体快速从想法到生产

Move from idea to production in hours with policy-driven autonomous AI agents. Unifi···

★ 206 2026-08-09
samples 开源

照着抄,快速搭建你的 AI 智能体应用

Agent samples built using the Strands Agents SDK.

★ 928 2026-08-09
lobehub 开源

把 AI 团队组织起来,7×24 小时自动干活

LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already···

★ 84327 2026-08-09
tenet 开源

让 AI 连续开发 12 小时,规格驱动+DAG 编排+三重评审,结果更靠谱。

Cross-platform AI agent harness for 12+ hour autonomous development cycles. Spec-dri···

★ 94 2026-08-09
mcp-nixos 开源

让 AI 直接查 NixOS 包和配置,生成配置更省心

MCP-NixOS - Model Context Protocol Server for NixOS resources

★ 879 2026-08-09
gaia 开源

在自家 PC 上跑 AI 代理,本地执行任务不传云

Build AI agents for your PC

★ 1617 2026-09-12
ToRA 开源

让大模型调用工具解数学题,准确率飙升

ToRA is a series of Tool-integrated Reasoning LLM Agents designed to solve challengi···

★ 1125 2026-08-09
agent-governance-toolkit 开源

给AI代理装上企业级安全阀,跑得再野也不怕

AI Agent Governance Toolkit — Policy enforcement, zero-trust identity, execution sa···

★ 6532 2026-08-09
SWE-agent 开源

丢个 GitHub issue 进去,AI 自动帮你改好代码

SWE-agent takes a GitHub issue and tries to automatically fix it, using your LM of c···

★ 20750 2026-08-09