garrytan/gbrain

⭐ 14,336  ·  TypeScript  ·  GitHub 仓库

Garry对OpenClaw/Hermes Agent的定制化决策核心

一句话总结

自接线知识图谱为AI智能体提供持久化、结构化的记忆，并具备经过生产验证的检索精度。

🔥 核心能力与独特卖点

• 自接线知识图谱 – 自动提取实体（人物、公司）并创建类型化关系（works_at、invested_in、founded），零LLM调用。解决了智能体将每次交互视为全新上下文窗口的痛点，支持无需手动设计模式的"谁在Acme AI工作？"等结构化查询。
• 带反向链接增强排序的混合搜索 – 结合向量嵌入、图遍历和反向链接信号，在基准测试中实现P@5 49.1%和R@5 97.9%。比纯向量和BM25方法高出31个百分点以上，直接解决了智能体跨会话丢失上下文的"聪明但健忘"问题。
• 34项预构建智能体技能 – 内置组织良好的技能文件（RESOLVER.md、AGENTS.md），指导AI智能体完成研究、综合和代码分析任务。省去了为常见操作手动编写智能体指令的麻烦。
• 支持OAuth 2.1的MCP服务器 – 通过stdio或HTTP暴露30多个MCP工具，配备生产级OAuth 2.1、作用域操作和内嵌React管理面板。实现与ChatGPT、Claude Desktop和Perplexity的远程智能体集成，同时不牺牲安全性。
• 内置基准测试与评估 – 支持LongMemEval、BrainBench-Real会话捕获和gbrain eval命令，实现可重复的检索质量测量。让团队能够证明其记忆系统有效，而非依赖轶事证据。

独特卖点： 一个经过生产验证的大脑（17,888页、4,383人、723家公司），将基于图的实体链接与向量搜索相结合，全部在浏览器中运行，无需外部基础设施，数据库初始化仅需2秒。

技术架构

组件	技术	详情
数据库	PGLite（浏览器内PostgreSQL）	2秒内就绪，无需服务器，完全本地运行
运行时	Bun（JavaScript/TypeScript）	CLI和服务器运行时，启动快速
搜索	混合（向量+图+反向链接）	将嵌入与实体链接和反向链接增强排序相结合
智能体协议	MCP（模型上下文协议）	支持stdio和HTTP传输
认证	OAuth 2.1	为远程客户端（ChatGPT、Claude Desktop、Perplexity）提供生产级认证
代码分析	Cathedral II引擎	调用图边与两遍检索（code-callers、code-callees、code-def、code-refs）
管理UI	内嵌React面板	通过http://localhost:3131/admin访问

快速入门指南

# 安装（独立CLI）
git clone https://github.com/garrytan/gbrain.git && cd gbrain && bun install && bun link

# 初始化本地大脑（2秒内就绪）
gbrain init

# 导入笔记
gbrain import ~/notes/

# 查询大脑
gbrain query "我的笔记中反复出现哪些主题？"

# 启动MCP服务器用于智能体集成（Claude Code、Cursor、Windsurf）
# 添加到MCP配置：
{
  "mcpServers": {
    "gbrain": { "command": "gbrain", "args": ["serve"] }
  }
}

# 带OAuth 2.1的远程MCP
gbrain serve --http --port 3131
open http://localhost:3131/admin

# 代码分析命令
gbrain code-callers searchKeyword
gbrain code-callees searchKeyword
gbrain code-def BrainEngine
gbrain code-refs BrainEngine
gbrain query "N+1处理是如何工作的" --near-symbol BrainEngine.searchKeyword --walk-depth 2

# 智能体安装（粘贴到智能体中）
检索并遵循以下位置的指令：
https://raw.githubusercontent.com/garrytan/gbrain/master/INSTALL_FOR_AGENTS.md

优点、缺点与使用场景

优点

• 大规模生产验证 – 索引了17,888页、4,383人、723家公司，检索指标强劲
• 极速设置 – 约30分钟即可获得一个功能完备的大脑；数据库2秒内就绪
• 零外部基础设施 – PGLite在浏览器中运行，无需服务器，无云依赖
• 强劲的基准测试表现 – P@5 49.1%，R@5 97.9%，比纯向量和BM25高出31个百分点以上
• 丰富的代码分析 – Cathedral II引擎为工程团队提供调用图感知的检索

缺点

• 无简单的npm/bun安装 – 由于postinstall钩子问题和包名占用，无法使用bun install -g或npm
• 需要手动克隆工作流 – 需要执行git clone + bun install + bun link序列
• npm注册表占用 – gbrain包名已被不相关项目占用
• 仅限本地操作 – sync_brain和file_upload在HTTP上被拒绝，限制了部分远程工作流

谁不应该使用此工具？

• 需要托管云服务的团队 – 这是自托管、本地优先的工具；无SaaS产品
• 非TypeScript/Bun环境 – 与Bun运行时紧密耦合；无Python、Go或Rust绑定
• 偏好GUI优先体验的用户 – 主要界面是CLI和MCP；管理面板为辅助功能
• 没有MCP兼容智能体的团队 – 如果不使用OpenClaw、Hermes Agent、Claude Code、Cursor或Windsurf，价值会大打折扣

理想使用场景

• AI智能体开发者 – 构建需要跨会议、邮件、通话和笔记拥有持久化、结构化记忆的自主智能体
• 使用GStack的工程团队 – 需要具备调用图遍历的代码感知检索
• 知识工作者 – 运行OpenClaw或Hermes Agent部署，想要一个真正能记住的"第二大脑"
• 评估检索质量的团队 – 内置基准测试让你能够测量并对比基线

社区与活跃度

拥有14,336颗星，最近更新于2026年5月10日，GBrain展现出强劲的社区兴趣和积极的维护状态。该项目显然在AI智能体开发社区中引起了共鸣，其快速的星标增长和生产级部署（索引了17,888页）就是明证。新颖的自接线知识图谱方法与具体的基准测试结果相结合，表明这并非空谈——而是一个团队正在积极使用和贡献的工具。