garrytan/gbrain

这是什么？

核心功能

• 01以带来源的明确事实形式保存记忆，并支持修正与撤回。
• 02默认无需密钥，使用本地 PGLite 与关键词检索；语义搜索为可选项。
• 03通过 stdio 或 HTTP 的 MCP 协议与命令行，将同一知识库提供给多个智能体。
• 04基于可信的本地页面写入构建类型化知识图谱，支持关系类查询。
• 05提供可选的综合回答功能，返回带引用的答案并指出知识缺口。
• 06支持使用带 pgvector 的 Postgres，适用于共享或更大规模的部署。

适用场景

• 为 Claude Code 或 Codex 等编码智能体提供跨会话的持久记忆。
• 让团队中的多个 AI 客户端共享同一个可检索的知识库。
• 为常驻个人智能体保存笔记、联系人与会议历史。
• 查询以 Markdown 笔记保存的人物、公司与交易之间的关系。

快速上手

1. 1

   使用 Bun 安装 GBrain（需要 Bun 1.4.0 或更新版本；不在 npm 上发布）

   bun install -g github:garrytan/gbrain
2. 2

   为 Claude Code 设置 GBrain（也可改用 codex）

   gbrain setup claude-code

使用前须知

• !需要 Bun 1.4.0 或更新版本。
• !不在 npm 上发布，npm 上同名的 gbrain 包与本项目无关，可能遮蔽真正的可执行文件。
• !要实现全天候运行需要一台 8GB 以上内存的服务器，并持续产生 API 令牌费用。
• !语义搜索、综合回答和后台增强需要云端服务商或另行配置的模型 API 密钥。

收录于专题

标签

常见问题

gbrain 是什么？

面向 AI 智能体的自托管记忆层，可保存带来源的明确事实，并在多个智能体与 MCP 客户端间共享同一个知识库。 GBrain 为 AI 智能体提供一个由你掌控的持久记忆。它以 Markdown 页面保存事实及其来源，支持修正和撤回事实，并可通过 MCP 或命令行把同一个知识库提供给多个智能体使用。默认的无密钥方案使用 PGLite 本地运行，仅依赖关键词检索；语义搜索、综合回答和后台补充则为可选功能，需要配置 Embedding 或模型服务商。

gbrain 可以免费使用吗？用的什么许可证？

gbrain 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

gbrain 还在维护吗？

活跃维护中。gbrain 最近一次提交是在 2026年11月6日。

gbrain 适合用来做什么？

为 Claude Code 或 Codex 等编码智能体提供跨会话的持久记忆。 让团队中的多个 AI 客户端共享同一个可检索的知识库。 为常驻个人智能体保存笔记、联系人与会议历史。 查询以 Markdown 笔记保存的人物、公司与交易之间的关系。

gbrain 怎么安装和运行？

使用 Bun 安装 GBrain（需要 Bun 1.4.0 或更新版本；不在 npm 上发布）: bun install -g github:garrytan/gbrain 为 Claude Code 设置 GBrain（也可改用 codex）: gbrain setup claude-code

在哪里获取 gbrain？

源代码和安装说明在 GitHub 上：https://github.com/garrytan/gbrain