gbrain 安装指南：本地个人 AI 助手从部署到秒搜的完整路径

【免费下载链接】gbrainGarry's Opinionated OpenClaw/Hermes Agent Brain项目地址: https://gitcode.com/gh_mirrors/gb/gbrain

你手头有一堆 Markdown 笔记，想找某条信息时翻不动文件夹？gbrain 是一个基于 Postgres 的个人知识库工具，自带混合 RAG 搜索：你把笔记导入它，再用关键词加语义的方式搜回来，也可以直接挂在 AI agent 上当长期记忆。适合两类人——想让本地文档可搜的开发者，以及想给 agent 配持久记忆的玩法。下面是本地部署到跑通搜索的完整路径。

🚀 gbrain 本地部署：clone 到 doctor 的最短路径

git clone https://gitcode.com/gh_mirrors/gb/gbrain cd gbrain && bun install && bun link

第一条克隆仓库；第二条安装依赖并把gbrain命令挂到 PATH。要求 Bun 1.4.0 及以上。注意 npm 上有个同名无关包，不要npm i -g gbrain，装错了gbrain doctor会报出来。

gbrain init gbrain doctor

init首次默认走 PGLite——Postgres 17.5 的 WASM 嵌入版，零配置开箱。你的知识库如果超过 1000 个 Markdown 文件，它会提示改用gbrain init --supabase，云端 Postgres 在并发和搜索速度上更稳。初始化时也可以加--no-embedding跳过嵌入配置，之后随时再开。doctor逐项检查 pgvector 扩展、RLS 策略和嵌入覆盖率，全绿再往下走。

🔍 文档怎么入库：导入与嵌入分开做

想让自己整理的笔记秒搜，分两步：

gbrain import /path/to/notes --no-embed gbrain embed --stale

第一条把目录里的页面存进库，--no-embed表示先不烧嵌入额度；第二条只给缺向量的页面补嵌入，不会整库重算，这也是补 embedding 最快的方式。gbrain 搜索配置支持混合检索：关键词命中和语义相似度一起参与排序，日常查询直接跑：

gbrain search "关键词" --limit 3

--limit控制返回条数。检索行为还有gbrain search modes这类子命令可调，按需再看。

🎙️ 语音进库：HD Voice 客户端

gbrain 的语音客户端走 WebRTC 通道，集成 RNNNoise 降噪，自动 VAD 和按键说话两种模式可切换，转写后的文本会写成 brain 里的页面，之后和普通笔记一样可搜。

具体搭建参考 recipes/agent-voice/ 下的配方文档。

接外部信息源：integrations 一览

gbrain integrations list

这条列出可接入的服务，邮件、日历、Twitter 之类都在其中；选定后按提示授权即可，agent 就能定期拉取这些来源的内容写进库，不必手动粘贴。

进阶：PGLite 与 Supabase 互迁（按需阅读）

gbrain migrate --to supabase把 PGLite 数据搬上 Supabase，--to pglite反向迁回；目标库非空时要加--force。迁移带断点续传，中断后重跑同一命令会继续复制未完成的页面。

运维三件事

• gbrain sync --no-pull --no-embed：把内容目录与数据库对齐；加--no-pull不拉远端 git，加--no-embed不自动补嵌入
• gbrain embed --stale：只给缺嵌入的页面补向量，增量成本最低
• gbrain doctor --json：JSON 输出检查结果，方便接定时任务做自动化告警

完整功能清单见 docs/guides/capabilities.md，更多进阶指南都在 docs/guides/ 目录。

【免费下载链接】gbrainGarry's Opinionated OpenClaw/Hermes Agent Brain项目地址: https://gitcode.com/gh_mirrors/gb/gbrain