GBrain

社区

为你的AI代理提供记忆与综合能力的开源大脑层。

分类: 其他第 30 / 230
Stars: ★ 31.0k 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Bun · 远程托管（无需本地环境）
凭据: 可选 API Key
许可证: MIT
最近提交: 3 天前
工具数: 10

66FMRS · C

GBrain是一个功能丰富的知识图谱和RAG引擎，提供独特的综合和缺口分析能力。它适合希望增强AI代理记忆的个人和团队，但需要一定技术背景来部署和配置。安全性方面，本地存储和多用户隔离设计良好，但需注意API密钥和令牌的安全。安装时务必从GitHub获取，避免npm包混淆。总体而言，对于需要真正“大脑”而非搜索的工具，这是一个强大的选择。

最强项 · 文档质量 16/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

13/20

维护活跃度

16/20

文档质量

16/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: README 描述了合理的启动路径（bun 安装、gbrain init --pglite、gbrain serve、30+ 工具的 MCP 握手），并记录了大量 bug 修复与规避方法，说明项目真实且可运行。但本次静态审查仅能访问 README 和仓库元数据，未提供实际 CI 工作流、已提交的测试或可执行示例。根据静态校准规则，没有可验证的执行证据时可靠性不能超过 12；缺失证据应扣分。大量故障排查条目也暗示存在未被测试覆盖的边界情况。得分 8。
安全与权限 13/20: 未发现红线问题：没有恶意软件、凭据窃取、隐蔽数据外传或未经确认的破坏性默认操作；示例中仅出现占位符 token gbrain_xxx，非真实密钥。README 描述了较完善的安全设计：HTTP 使用 OAuth 2.1 + PKCE、read/write/admin 作用域隔离、限流、DCR 风格注册、凭据网关以及 SECURITY.md 威胁模型。但这些均为 README 中的声明，无法审查实际源码；同时未文档化危险写/管理操作的显式确认流程，多用户数据边界“零泄漏”的模糊测试结果也未经证实。得分 13。
维护活跃度 16/20: 仓库未归档，采用 MIT 许可证，包含 CONTRIBUTING、SECURITY.md，以及引用多个近期版本（如 v0.41.37.0）的详细 CHANGELOG。README 描述了 PR 批次合并流程与贡献者署名，说明维护有组织。300 个 open issues 数量偏高，但与活跃项目相符；提供的材料中没有发布节奏或提交数据。得分 16。
文档质量 16/20: README 异常详尽：快速开始、代理安装、面向多种客户端的 CLI/MCP 配置（Claude Code、Codex、Cursor、ChatGPT、Perplexity、Cowork）、架构、集成、成本提示，以及带具体修复和版本引用的故障排查章节。限制也已披露（macOS 26 上 PGLite 不兼容、npm 同名包警告、PGLite 单写者）。主要扣分点是链接的文档（INSTALL.md、docs/mcp/*、SECURITY.md 等）未提供以供核验，部分声明（如基准数字）无法从现有材料证实。得分 16。
安装易用性 13/20: 安装步骤清晰：通过 bun install -g github:garrytan/gbrain 安装、初始化本地 brain、运行 gbrain serve，然后通过主流客户端的一键命令示例连接。给出了平台注意事项（macOS 26/Tahoe 的 PGLite 问题、Windows DNS 规避）。但安装依赖 bun、需要 embedding API 密钥，可能还需远程主机；多个手动选择（embedding 提供商、schema 包）增加了摩擦。根据静态校准规则，未提供可验证的 CI/测试文件时 setup 不能超过 15，而本材料中未提供此类文件。得分 13。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么写入 / 删除本地文件执行命令或代码访问网络连接数据库

适合谁

需要超越搜索的答案（综合+缺口分析）的个人知识管理
希望建立团队共享记忆的组织（需OAuth范围控制）
需要持久记忆的AI代理（自动摄取、丰富、固化）

不适合谁

需要严格实时数据流的场景（依赖定时同步和爬取）
没有API密钥或不想配置嵌入模型的用户（需要至少一个嵌入提供商）
需要云托管服务的用户（需要自行部署）

所需权限

读取和写入本地文件系统（用于大脑仓库和导入）
网络访问外部API（解锁嵌入提供商、LLM、摄取Webhook）
环境变量访问API密钥（如OPENAI_API_KEY等）
本地数据库（PGLite或Postgres）

风险与副作用

安装包混淆：npm上的`gbrain`包无关，可能导致冲突，需仅从GitHub安装
数据隐私：本地数据安全，但远程部署时需保护OAuth令牌和API密钥
LLM成本：`think`和综合功能消耗LLM API调用，可能产生费用
性能问题：大型大脑同步可能耗时或卡顿（已提供故障排除）

安装接入

准备工作

运行环境：Bun · 远程托管（无需本地环境）

GBRAIN_REMOTE_TOKEN 可选密钥连接远程 gbrain serve --http 服务器时使用的 bearer 令牌，由服务端管理面板签发。

OPENAI_API_KEY 可选密钥 OpenAI 的 API 密钥，作为默认的嵌入（embedding）提供方；在 OpenAI 平台获取。

ZEROENTROPY_API_KEY 可选密钥 ZeroEntropy 的 API 密钥，默认的嵌入与重排序提供方；在 zeroentropy.dev 获取。

VOYAGE_API_KEY 可选密钥 Voyage AI 的 API 密钥，可选的嵌入提供方；在 Voyage AI 平台获取。

其他可选配置项（7 个）

GBRAIN_FTS_LANGUAGE 可选配置 Postgres 全文检索分词语言，默认 english，可设为 portuguese、spanish 等。

GBRAIN_BULK_MAX_RETRIES 可选批量写入在 Supabase/Supavisor 连接抖动时的最大重试次数，默认 3。

GBRAIN_BULK_RETRY_BASE_MS 可选批量写入重试的基础等待毫秒数，默认 1000。

GBRAIN_BULK_RETRY_MAX_MS 可选批量写入重试的最大等待毫秒数，默认 10000。

GBRAIN_SYNC_TRACE 可选设为 1 时 gbrain sync 会打印每个文件的导入开始日志，用于定位卡死文件。

GBRAIN_MAX_REGEX_INPUT_CHARS 可选限制 schema pack 推理正则的输入长度上限，防止 ReDoS。

GBRAIN_CONTRIBUTOR_MODE 可选设为 1 时启用 eval export / replay 等贡献者模式功能。

安装步骤：1. 安装 Bun 运行时。2. 运行 bun install -g github:garrytan/gbrain（注意：npm 上的 gbrain 包无关，不要使用）。3. 初始化本地大脑：gbrain init --pglite。4. 验证安装：gbrain doctor。5. 将 MCP 服务器连接到客户端：例如 Claude Code 使用 claude mcp add gbrain -- gbrain serve；或者远程使用 gbrain connect https://your-host/mcp --token gbrain_xxx --install。

验证是否装好

运行 gbrain init --pglite 后执行 claude mcp add gbrain -- gbrain serve，重启 Claude Code，在工具列表中应能看到 gbrain 的 search / think / put_page 等工具；再运行 gbrain doctor 确认健康检查通过。

常见排障

`gbrain init --pglite` 在macOS 26.x上崩溃：使用原生Homebrew PostgreSQL + pgvector
`gbrain import` 报维度错误：运行`gbrain doctor`并按照修复命令操作
定时同步超时：使用 `--break-lock --all --max-age` 和按源同步循环
梦周期丢失链接：升级到v0.41.19.0+并使用重试环境变量
PGLite单写者冲突：大型同步时先停止`gbrain serve`

试试这样问

连接成功后，可以直接对 AI 助手这样说：

帮我搜索一下关于 Acme 的所有笔记，然后总结谁在 Acme AI 工作（用 search 和 think 工具）
把这段话记进我的知识库：今天和 Bob 讨论了定价方案
用 graph-query 查一下 Bob 这个季度投资了哪些公司
把我 ~/notes 目录导入大脑并同步（用 import 和 sync 工具）

工具能力 10

search 只读

混合检索，返回按分数排序的原始页面列表。

think 只读

综合检索结果，生成带引用的答案和知识缺口分析。

put_page 写入

写入页面并自动提取实体关系（零LLM调用）。

graph-query 只读

执行多跳知识图谱查询。

schema_apply_mutations 写入

批量应用模式变更（管理员权限，远程可用）。

capture 写入

捕获想法或文件内容为页面。

agent 写入

通过任务队列运行子代理，执行思考操作。

sync 写入

同步数据源（如导入、同步）。

展开其余 2 个工具

import 写入

导入文件或目录到大脑。

query 只读

执行检索或综合查询（别名）。

使用场景

在会议前获取关于某个人的综合摘要（如“与Alice开会前需要了解什么”）

查询知识图谱中的关系（如“谁在Acme AI工作？”）

作为团队的共享机构记忆，按登录隔离（公司大脑）

为编码代理提供长期记忆，避免忘记非代码上下文

支持客户端

Claude Desktop

Claude Code

Codex

Cursor

Windsurf

Perplexity

ChatGPT

Claude Cowork

依据项目文档列出，未经本站实测。

详细介绍

GBrain 是一个开源的知识图谱与检索增强生成（RAG）引擎，由 Y Combinator 总裁 Garry Tan 开发，用于驱动他自己的 AI 代理。它提供混合搜索（向量+关键词+重排序）、自我构建的知识图谱以及综合层（think），可直接返回带引用的答案并指出知识缺口。它支持个人使用或作为团队的公司大脑，通过 OAuth 和范围控制实现多用户隔离。它可通过命令行、MCP（stdio/HTTP）或集成到 Claude Code、Codex、Cursor 等客户端中使用。它使用 PGLite（零配置）或 Postgres + pgvector 作为后端。