garrytan/gbrain

GBrain – 个人代理记忆守护进程

它是什么

GBrain 是一个自托管服务，为任何基于 LLM 的代理提供一个结构化、可编辑的记忆存储，由你控制。它记录事实（页面）及其来源 URL，让你更正或撤回条目，并可将该知识呈现为原始块、综合答案或类型化知识图谱。

关键概念

明确、富含来源的事实 – 每条信息都存储为带有引用的页面，因此代理可以指向原始来源。
更正与撤回 – 你可以更新或删除事实，系统会跟踪这些更改。
跨代理共享 – 同一个大脑可以附加到多个代理（例如 Grok Bot、Muse、Claude Code、Codex），同时保持每个代理的身份独立。
可选层 – 从简单的关键词检索开始；之后启用语义搜索、基于 LLM 的综合（带引用的答案）或图视图以进行关系查询。
公司大脑模式 – 通过身份验证，远程客户端只能在你授予的权限内读取/写入，使其可用作共享的企业知识库。

如何使用

添加到现有代理 – 运行 gbrain setup <harness> 命令（Claude Code、Codex、Grok Bot 等）。该工具会将一个小型启动器注入代理，创建本地大脑目录，并连接 MCP（“内存客户端协议”），以便代理可以调用 remember、recall、correct 等。
作为独立服务运行 – gbrain init … 创建一个守护进程，你可以通过 MCP（例如通过 Tailscale tailnet）公开。其他机器或云代理随后可以说 “通过 mcp 使用我的大脑” 来连接。
连接托管大脑 – 使用 OAuth / 私人机器流程将远程大脑附加到云托管的 harness。

典型工作流程

守护进程持续摄取你的数据（电子邮件、会议笔记、推文、语音转录等），并在夜间丰富它。
当你提问时，代理会调用大脑：
- 关键词/语义搜索 → 返回相关页面。
- 综合层（可选）→ LLM 构建简洁答案，引用每个事实，并添加 差距分析 注释，告诉你大脑不知道什么。
- 图适配器（可选）→ 你可以提出关系问题，例如 “谁在 Acme 工作？”，并从存储的边获得答案，而无需额外的 LLM 调用。

为何重要

消除“搜索然后阅读”循环：大脑为你进行阅读和总结。
为个人或企业知识提供单一事实来源，具有可审计的来源。
在你的硬件和数据上运行，因此你保留对隐私和成本的控制。

安装快照

# 通过 Bun 安装二进制文件（所需版本 ≥ 1.4）
bun install -g github:garrytan/gbrain

# 快速设置 Claude Code（或 Codex）
gbrain setup claude-code   # 添加 --dry-run 预览，--remove 还原

setup 命令创建大脑目录、写入 MCP 钩子，并运行健康检查（gbrain doctor）。
对于纯 CLI 大脑（无代理），你可以运行：

gbrain init --pglite --no-embedding   # 无密钥、本地 SQLite 风格存储
gbrain import ~/my-notes/ --no-embed  # 索引 markdown 文件

远程公开：gbrain mcp expose（可选 --funnel 用于云代理）通过你的 Tailscale 网络发布守护进程。

支持的代理 / 集成

Grok Bot – 安装一个隔离的启动器，将大脑保留在你的机器上。
Muse / Muse Code – 类似的流程，具有原生可编辑内存加上 GBrain 的可移植层。
Claude Code 和 Codex – 基于插件的安装（codex plugin add gbrain@gbrain 等）
OpenClaw / Hermes – 全栈部署，大脑在服务器上 24/7 运行。
任何 MCP 兼容客户端 – Cursor、Windsurf、自定义 stdio 工具可以在其 MCP 配置中添加 gbrain 命令。

性能提示

内置基准测试（BrainBench）显示图适配器可提高关系查询的精确度/召回率（P@5 0.342 对比 0.192，与纯混合检索相比）。

安全性与限制

大脑不保证远程调用者无法看到本地文件；权限按来源和操作执行。
守护进程不通过 npm 发布 – 安装错误的 gbrain 包可能会遮蔽真实的二进制文件。README 警告仅使用基于 Bun 的安装。

结论 GBrain 是 LLM 代理的生产级、自托管记忆层。它让你在控制下保留可搜索、有引用支持的知识库，在个人或企业代理之间共享，并可选择获得 LLM 生成的答案或图式查询，而无需离开你自己的基础设施。

garrytan/gbrain

GBrain – 个人代理记忆守护进程

相关