gbrain 是什么?

GBrain 是 Garry Tan 发布的代理记忆系统,以 Markdown/git 保存可追溯资料,并用 PGLite 或 PostgreSQL 建立关键词、向量与知识图谱检索。它可通过 CLI 或 MCP 连接现有代理。

⭐ 25,795 Stars 🍴 3,723 Forks TypeScript MIT 作者: garrytan
来源:github.com/garrytan/gbrain;https://github.com/garrytan/gbrain/blob/ma… 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

官方仓库当前约 3.02 万星,并于 2026-09-22 发布 v0.51.8.0,说明项目仍在快速迭代。

来源:github.com/garrytan/gbrain/releases/tag/v0.51.8.0

核心功能

可追溯记忆

显式事实保留来源,支持修正和撤回;同一记忆可供多个已授权代理使用。

来源:github.com/garrytan/gbrain/blob/master/README.md
自织知识图谱

写入页面时从显式引用提取类型化边,不调用 LLM;图查询可补足纯文本相似度检索。

来源:github.com/garrytan/gbrain/blob/master/README.md
双存储引擎

本地小规模可用 PGLite,大规模或多人场景使用 PostgreSQL/pgvector;二者实现同一 BrainEngine 合约。

来源:github.com/garrytan/gbrain/blob/master/docs/INSTALL.md;https://github…
MCP 与后台任务

支持 stdio/HTTP MCP、OAuth 范围、持久任务和可选夜间整理;远程暴露需要单独配置认证和网络入口。

来源:github.com/garrytan/gbrain/blob/master/docs/INSTALL.md

技术架构

Markdown/git 是可读资料层,PGLite 或 PostgreSQL 保存索引、事实、修正、任务和账户数据。BrainEngine 统一引擎操作,CLI 与 MCP 调用同一核心;写入后抽取实体边,搜索可组合关键词、向量、图关系、重排和合成。后台 autopilot 负责同步与整理。

来源:github.com/garrytan/gbrain/blob/master/README.md;https://github.com/g…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Git Bun >=1.3.11 PGLite 或 PostgreSQLPGLite 或 Post… 可选 OpenAI、Anthropic、Voyage 等 API key可选 OpenAI、An… 可追溯记忆 自织知识图谱 双存储引擎 MCP 与后台任务 gbrain 项目本体 核心功能 关键依赖

技术栈

语言TypeScript,Bun 1.3.11+框架PGLite 或 PostgreSQL/pgvector、MCP SDK、Express、可选模型提供方
GitBun >=1.3.11PGLite 或 PostgreSQL可选 OpenAI、Anthropic、Voyage 等 API key
本地 stdio MCP 可不开放端口;HTTP MCP 需要 OAuth、HTTPS、范围和速率限制
来源:github.com/garrytan/gbrain/blob/master/package.json;https://github.co…

快速上手

从 GitHub 安装固定 v0.51.8.0,不要安装 npm 上同名的无关包。先在空测试目录运行 PGLite keyless 模式,执行 doctor,并用虚构事实验证 remember、recall、correction 和 withdrawal。确认本地权限后再接入 MCP;HTTP 或 Tailscale Funnel 只能在配置 OAuth 和最小范围后启用。
来源:github.com/garrytan/gbrain/blob/master/README.md;https://github.com/g…

使用场景

适合希望代理跨会话保存来源、修正和实体关系的个人或团队。邮件、日历、联系人和会议导入会集中大量敏感数据;先做最小样本、删除演练、完整数据库备份和逐客户端授权。

来源:github.com/garrytan/gbrain/blob/master/README.md;https://github.com/g…

优势与局限

优势

  • 记忆带来源、修正和撤回
  • PGLite 可从 keyless 本地模式开始
  • 知识图谱建边不依赖 LLM
  • CLI、MCP 和双引擎共享核心合约

局限

  • Git 仓库不是完整备份,数据库还保存事实、任务和账户状态
  • 语义检索、合成和后台整理会增加模型费用和数据外发
  • 远程 MCP 与多人脑需要严格 OAuth 范围
  • 官方 BrainBench 是项目方自评,不能外推到所有语料
  • 本轮未安装、导入或运行任何模型
来源:github.com/garrytan/gbrain/blob/master/README.md;https://github.com/g…

最新版本

最新正式版 v0.51.8.0 发布于 2026-09-22。包元数据要求 Bun 1.3.11 以上;项目更新很快,升级前应阅读授权和队列迁移说明并备份数据库。

来源:github.com/garrytan/gbrain/releases/tag/v0.51.8.0;https://github.com/…

实测与证据

status: official_docs_checked_not_run  |  checked_at: 2026-09-23  |  environment: 核对官方 README、INSTALL、package.json 与 v0.51.8.0 Release  |  limitations: 未安装 Bun/GBrain,未创建 PGLite/Postgres,未接入 MCP、Tailscale、邮件或模型,也未复跑 BrainBench  |  observed_output: package.json 标注 0.51.8.0 和 Bun >=1.3.11;README 明确 npm 同名包无关,推荐从 GitHub 安装;官方文档区分 keyless、provider key、本地 stdio 和远程 HTTP MCP

来源:github.com/garrytan/gbrain/blob/master/package.json;https://github.co…

同类项目对比

EverOS 同样提供本地代理记忆,但以 Markdown 为源数据并同步 SQLite/LanceDB,最小真实流程需要 LLM key。GBrain 可从 keyless 的 PGLite 和记忆协议开始,并增加来源、修正、撤回、图关系和 MCP 授权。偏好简单 Markdown/API 时评估 EverOS;需要图关系与多代理授权时评估 GBrain。

来源:github.com/EverMind-AI/EverOS;https://github.com/garrytan/gbrain/blob…

总结评价

GBrain 适合需要来源、修正、图关系和跨代理访问控制的长期记忆场景。先用本地 keyless PGLite 和虚构数据验证四步记忆生命周期,再决定是否增加模型 key、后台任务或远程 MCP。

来源:github.com/garrytan/gbrain/blob/master/README.md;https://github.com/g…

常见问题

GBrain v0.51.8.0 应该从 npm 安装吗?

不应该。官方明确说明 npm 上名为 gbrain 的包与本项目无关,应使用 GitHub 安装路径或源码安装。

GBrain 没有模型 API key 能工作吗?

可以。keyless 模式支持 PGLite、关键词检索和代理显式写入的记忆;向量、自动抽取、合成和后台整理需要另配提供方。

备份 GBrain 的 Markdown 仓库是否足够?

不够。数据库还保存事实、修正、任务和账户数据,官方要求使用完整数据库备份与恢复流程。

GBrain HTTP MCP 可以直接暴露公网吗?

不应直接裸露。需要 HTTPS、OAuth 客户端、最小 read/write/admin 范围、速率限制和受控网络入口;Funnel 也是显式选择。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件