GBrain

GBrain 是一个专为 AI 代理设计的个人知识库框架。它解决了当前 AI 助手最大的痛点：缺乏长期记忆和上下文连贯性。

GBrain 将你的会议记录、电子邮件、推文、日历事件、语音通话和原创想法汇聚成一个可搜索的、结构化的 Markdown 知识库。每次对话前，代理会读取相关背景；每次对话后，代理会将新信息写入知识库。通过这种“读取-回复-写入”的闭环，你的 AI 代理每天都在变得更聪明、更懂你。

核心理念：从“工具”到“伙伴”

大多数 AI 工具只是帮你“查找”信息，而 GBrain 帮你“积累”智慧。

• 无状态 vs 有状态：传统代理每次对话都是全新的开始；GBrain 代理拥有持久的记忆，记得你上周提到的项目细节，也记得你三年前见过的某人。
• 被动检索 vs 主动丰富：不仅在你提问时检索，还会在后台自动同步、实体检测、修复引用，甚至在你睡觉时整理记忆。

快速开始：30 分钟拥有一个“大脑”

GBrain 设计为由 AI 代理（如 OpenClaw 或 Hermes Agent）自动安装和配置。你只需提供 API 密钥，剩下的交给代理。

1. 前置准备

你需要一个能够运行后台任务和 Cron 作业的持久化 AI 代理环境：

• OpenClaw: 推荐在 Render 上部署 AlphaClaw。
• Hermes Agent: 推荐在 Railway 上部署。

2. 一键安装与配置

将以下指令发送给你的 AI 代理，它将全自动完成所有步骤：

“目标：我想要一个真正有效的、有主见的 AI 代理设置。带我到达那里。
安装 GBrain，设置大脑模式，导入我的文件，配置所有集成，
并验证所有内容是否正常工作。不要跳过步骤。
在进行下一步之前验证每一步。如果某一步失败，停下来并修复它。”

3. 手动安装（CLI 模式）

如果你希望独立使用或手动控制：

# 1. 安装 Bun (如果尚未安装)
curl -fsSL https://bun.sh/install | bash && source ~/.bashrc

# 2. 安装 GBrain
bun add github:garrytan/gbrain

# 3. 初始化本地大脑 (基于 PGLite, 无需服务器, 2秒就绪)
gbrain init

# 4. 导入现有 Markdown 笔记
gbrain import ~/Documents/Notes --no-embed

# 5. 生成向量嵌入 (启用语义搜索)
gbrain embed --stale

# 6. 测试查询
gbrain query "我最近关于 AI 代理的主要想法是什么？"

技术架构：轻量且强大

1. 数据库：PGLite + Supabase

• 默认本地运行：使用 PGLite（通过 WASM 实现的嵌入式 Postgres 17.5），无需 Docker，无需连接字符串，启动仅需 2 秒。内置 pgvector 支持混合搜索。
• 无缝迁移当知识库超过 1000+ 文件或需要多设备同步时，一键迁移至 **Supabase托管 Postgres：

  gbrain migrate --to supabase
  

2. 知识模型：Markdown as Code

• 目录结构：遵循 MECE 原则（相互独立，完全穷尽），如 people/, companies/, concepts/。
• 自描述：每个目录包含 `README.md解析器，告诉代理如何理解该类别的数据。
• Git 友好：整个大脑就是一个 Git 仓库，版本控制、备份和协作天然支持。

3. 集成配方 (Recipes)

GBrain 通过“配方”机制轻松连接外部数据源。代理会读取配方，询问必要的 API 密钥，并自动完成配置和验证。

杀手级应用：“Her”式语音体验

GBrain 最震撼的功能是其语音集成。

1. 拨打一个电话号码，你的 AI 代理接听。
2. 身份识别：它知道是谁打来的，并从数千个人物页面中提取完整背景（上次见面时间、共同好友、未决事项）。
3. 自然对话：基于完整上下文的交流，而非机械问答。
4. 自动归档：通话结束后，自动生成包含转录、实体检测和交叉引用的记忆页面。

这不是演示，这是生产环境。 它运行在真实电话号码上，能筛选未知来电，且每次通话都在优化代理对你的理解。

复合智能循环

GBrain 的核心价值在于其自我强化的学习循环：

1. 信号到达：新邮件、会议、推文进入系统。
2. 实体检测：代理识别其中的人、公司、概念。
3. 读取 (Read)：代理先查询大脑，获取历史背景。
4. 回复 (Reply)：基于完整上下文给出高质量回答。
5. 写入 (Write)：将新产生的洞察、事实更新到对应的 Markdown 页面。
6. 同步 (Sync)：重新索引，为下一次查询做准备。

结果：

• “谁既认识 Pedro 又认识 Diana，我应该邀请谁共进晚餐？” → 代理交叉引用社交图谱，给出精准建议。
• “帮我准备 30 分钟后与 Jordan 的会议” → 代理提取档案、共同历史、近期活动和未决话题，生成简报。