登录 注册

gbrain (智能体大脑实现)

曾爆款
去点 Star
AI 应用与 AI Agent
32,379
Stars
4,816
Forks
135
Watchers
809
Open Issues
MIT
许可证
TypeScript
语言
2026-04-05
创建时间
2026-11-10
最近更新

项目能做什么

一款自主可控的 AI Agent 记忆系统,支持跨 Agent 共享记忆、存储带来源的事实与修正撤回,并提供关键词和语义检索。
来源:AI 基于仓库事实生成 · 内容以仓库实际 README 为准

使用说明 查看原始 README 原仓库文档

# GBrain 中文使用说明

## 项目简介
GBrain 是由 Y Combinator 总裁兼 CEO Garry Tan 开源的 AI Agent 记忆系统(Agent Brain),用于为其自用的 OpenClaw 与 Hermes 部署提供支持。它允许你为现有的各类 Agent 赋予自主可控的长期记忆,支持保存明确事实及其来源(出处)、纠错与撤回,并在不同 Agent 间共享同一份记忆。项目采用 MIT 协议,完全支持本地自托管(同时也提供 gbrain.io 付费托管服务)。

## 核心功能
- **记忆与检索机制**:初始支持无 API Key 的本地记忆与关键词检索;后续可按需扩展语义搜索、综合生成(Synthesis)与后台自动丰富。
- **回答综合层(Synthesis Layer)**:不仅返回检索片段,还可直接生成附带引用的完整回答,并明确指出知识库中尚不清楚的盲区(Gap analysis)。
- **类型化知识图谱(Typed Knowledge Graph)**:本地写入页面可自动提取关联引用;支持毫秒级广度优先遍历以查询实体关系(如“谁在某公司工作”)。
- **后台常驻守护**:支持通过定时任务(Cron jobs)实现自动化摄取、实体丰富、引用修复与夜间记忆整理整合。
- **跨 Agent 共享与 MCP 支持**:支持接入各类 AI 客户端,能够通过 Model Context Protocol (MCP) 以及 Tailscale 网络将本机大脑暴露给远程/云端 Agent。
- **支持团队/企业共享大脑**:提供基于来源、操作权限和可见性过滤的访问边界控制。

## 适合谁用
- 正在使用现有 Agent(如 Grok Bot、Muse、Codex、Claude Code、ChatGPT、Cursor 等),希望为其补充持久、可追溯长程记忆的开发者。
- 希望在多款 Agent 工具间复用、共享同一套个人或团队知识库的用户。
- 追求数据自主可控,希望在自己的硬件、数据库上运行私有化记忆系统的人群。

## 安装步骤
> 此部分原文未说明具体安装命令或前置依赖步骤(如 pip、Docker 等),请查看原仓库。

README 中提及的接入/运行场景如下:
- **通过 MCP 本地暴露并运行**:
  ```bash
  # 在本地通过 Tailscale tailnet 暴露 MCP 服务并保持运行
  gbrain mcp expose

  # 若对接云端 Agent(如 Grok Bot、Muse、ChatGPT 等),增加 --funnel 参数
  gbrain mcp expose --funnel
  ```
- **云端免安装方案**:可直接使用官方托管服务 gbrain.io,无需本地安装与维护。

## 配置说明
- **启动与费用模式**:支持“无 Key 启动”(Start keyless)。宿主 Agent 的订阅费与单独配置的 Model API 调用费用互为独立。
- **网络与权限配置**:
  - 本地大脑通过 Tailscale 共享时,可直接向 Agent 发送指令(如:`"use my brain over mcp"` 或 `"put my brain on tailscale"`)。
  - 连接托管大脑支持原生 OAuth 或专用私有机器连接;仪表盘管理与权限使用专门的 Owner 凭据通过 `docs/mcp/ADMIN.md` 配置。
  - *详细的环境变量与数据库配置原文未完整提供,请查看原仓库文档。*

## 常见问题
- **Q: 权限边界能完全保证本地文件不泄露吗?**  
  A: 不能。认证的远程客户端受来源和操作授权约束,但本地文件和共享数据库凭据属于不同的信任边界,仅靠 Source 机制无法绝对隔离调用者。设置共享前需参考官方的安全边界说明。
- **Q: Grok Bot 与 Grok Build、Muse 与 Muse Code 是一回事吗?**  
  A: 不是,它们是独立的产品形态,接入时需参考对应的官方指南。
- **Q: 遇到问题如何寻求支持?**  
  A: 如果使用托管版或初次上手遇到卡点,可通过 support@gbrain.io 联系官方协助配置。
原始 README 摘录(英文原文,节选前 3000 字符)
<h1><picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/brand/gbrain-wordmark-light.svg"><img src="docs/images/brand/gbrain-wordmark.svg" alt="GBrain" height="52"></picture></h1>

**Give the agent you already use a memory you control.** GBrain stores explicit facts with their sources, supports corrections and withdrawal, and makes the same memory available across your agents. Start with keyless memory and keyword retrieval; add semantic search, synthesis, and background enrichment when you need them.

GBrain is MIT-licensed and free to self-host; gbrain.io is optional paid hosting.

> [!TIP]
> **Need hosted? First time running an agent?** Try **[gbrain.io](https://gbrain.io/?ref=readme)**, hosted GBrain, for the easiest experience: one brain for you and your team, connected to ChatGPT, Claude and Cursor, with nothing to install or keep online. Stuck? Email support@gbrain.io and a person will set it up with you, free.

**Keep skills beside knowledge.** New local brains include memory skills in their
content root. Agents can join an authorized catalog; only approved editors can
publish. Managed coding-agent installs add an owned native router; restart and
real-use verification are separate steps. Staged migration preserves sharing
choices and personal edits. See [shared brain skills](docs/guides/shared-brain-skills.md).

## Choose your setup

1. **Add GBrain to my existing agent — recommended.** Keep your agent's identity and save memory inside its environment. No new personal-agent identity or private repository is required. Start with the guide for **[Grok Bot](docs/guides/grok-bot.md)**, **[Muse](docs/guides/muse.md)**, or **[Codex / Claude Code](docs/tutorials/connect-coding-agent.md)**. [Other harnesses](#connect-gbrain-to-your-ai-client-mcp).
2. **Use the brain on my own computer from everywhere.** One command publishes it over MCP on your Tailscale tailnet and keeps it running: `gbrain mcp expose` (add `--funnel` for cloud agents such as Grok Bot, Muse and ChatGPT). Follow **[use your brain from anywhere over MCP](docs/guides/remote-mcp.md)**. **Say to your agent:** *"use my brain over mcp"* — *"put my brain on tailscale"*.
3. **Connect my existing hosted brain.** Follow **[hosted harness access](docs/guides/hosted-harness-access.md)** to choose native OAuth or a private machine connection. For dashboard login, clients, and permissions, use **[MCP administration](docs/mcp/ADMIN.md)** with the server's separate owner credential. Delegation is an explicit choice.

Grok **Bot** and Grok **Build** are different products. Muse's personal agent and **Muse Code** are different products too. Muse already has native editable memory; GBrain adds an explicit, portable record with provenance and shared access. See each guide's dated evidence and remaining verification steps.

I'm Garry Tan, President and CEO of Y Combinator. I built GBrain to run my own AI agents. It's the production brain behind my OpenClaw and Hermes deployments:
阅读完整原文

商业机会分析 AI 生成

托管型团队/个人 Agent 记忆中枢 (SaaS/Hosted MCP)

产品构想基于开源协议提供开箱即用的多Agent共享记忆云服务,通过标准MCP协议一键连接Cursor、Claude Code及各类Bot,免去自建Tailscale和本地服务器的门槛。
核心功能一键生成MCP连接端点、多Agent身份与鉴权管理、在线可视化记忆查看与纠错面板、自动夜间记忆整理(Consolidation)服务。
目标用户不想折腾自托管服务器、在多台设备(Mac/PC/云端)间使用AI Agent的独立开发者和中小团队。
难度/周期中等 · 3 - 5 周 · 成本:< $100/月(主要为托管服务器、向量存储与基础数据库成本)
收费模式按存储条目/每月检索请求量的SaaS订阅制(Freemium模式,如$9/月个人版,$29/用户/月团队版)。
竞争风险官方本身已推出商业化站点 gbrain.io,存在与作者/官方托管直接竞争的压力,需在差异化定价或垂直场景寻求突破。
依据 已验证事实

垂直领域(如投资/销售)自动记忆与人脉扩展插件包

产品构想针对高净值人群或商务用户,打造开箱即用的特定源导入管道(如Google Meet录音转录、Gmail、Twitter/X),自动解析提取人物、公司事实并沉淀至GBrain。
核心功能会议/邮件/社媒连接器、实体自动抽取与丰富(Enrichment Pipeline)、人物/公司关系图谱检索接口、与CRM双向同步。
目标用户投资人、商务拓展(BD)、创始人等日常处理大量非结构化会议与邮件的高管用户。
难度/周期较高 · 6 - 8 周 · 成本:< $300/月(第三方API转录与大模型Enrichment调优调用开销)
收费模式高客单价订阅或单次定制交付,企业席位费($50~$100/席位/月)。
竞争风险数据涉及隐私(邮件与会议记录),安全合规与模型处理错误带来的用户信任风险较高。
依据 AI推测

企业私有化部署与合规多租户中介服务

产品构想为有数据安全诉求的中小企业提供私有化部署集成服务,针对GBrain开源版在本地文件和共享库无强制隔离的弱点,提供企业级RBAC和审计日志扩展层。
核心功能Docker/K8s一键私有化部署套件、企业级细粒度权限管控网关、操作审计与数据撤回溯源面板、本地LLM/Embedding接入适配。
目标用户对数据隐私敏感的技术公司、合规要求严格的设计/咨询机构。
难度/周期较高 · 4 - 6 周 · 成本:< $50/月(开发与测试环境)
收费模式一次性部署实施费($2000-$5000/次) + 持续维护订阅或按年支持费。
竞争风险销售周期长,中小团队私有化交付边际成本较高。
依据 数据支持的判断
AI 基于仓库公开数据分析生成,含推测成分,不构成收益承诺。
报告会保存到 个人中心

竞品与相似项目 GitHub Search 真实检索

项目中文简介Stars语言
huytieu/COG-second-brain 具自进化能力的第二大脑,集成多智能体、人脉 CRM 与闭环验证机制。 1,376 Python
garrytan/gbrain-evals 中文介绍暂未生成
482 TypeScript
naveedharri/baalda 团队第二大脑,基于本地 Markdown 实现多人实时协作与 AI 共同读写。 323 HTML
mage0535/hermes-memory-installer 面向 AI 智能体的生产级外挂记忆系统,支持三层回忆与多智能体兼容。 208 Python
vladignatyev/brain-map-skill 将 Markdown 笔记目录转换为包含力导向图与时间线的交互式知识图谱。 74 Python
howardpen9/hermes-gbrain-bridge 将 Hermes/OpenClaw 智能体记忆转换为 gBrain 可导入的 Markdown。 70 TypeScript
以上为通过 GitHub 官方 Search API 检索的相似项目,功能差异与优劣势需进一步人工确认,配置 AI 后可生成对比分析。

项目优势与风险

技术成熟度创建于 2026-04-05,近 30 天仍在推送,发布过 100 个 Release
社区活跃Star 32,379 / Fork 4,816 / Issue 809(数据支持,可自行核实)
许可证MIT
主要风险上游项目方向可能变化;同赛道竞争者较多(见竞品表);热度与需求不完全等价

安装与使用

快速开始(以仓库 README 为准)
git clone https://github.com/garrytan/gbrain.git
cd gbrain
# 请阅读仓库 README 获取确切安装步骤(依赖、配置、启动命令)
阅读原仓库文档
术语说明:Docker=应用容器(把程序和依赖打包运行);API Key=调用外部服务的密钥;Git Clone=把仓库代码下载到本地。常见错误:API Key 未配置 / 端口占用 / 数据库连接失败,多数项目在 README 的 Troubleshooting 章节有说明。