🔧 开源框架

Brigade

自托管的个人多 Agent 运行时(TypeScript,MIT):一支共享长期记忆 Tideline 的 Agent 班组,org chart 治理谁跟谁说话,会话中途可换模型(Carrow),接 1000+ 应用与 WhatsApp/Telegram/Slack 等渠道,无账号无 SaaS、密钥只存本机(0600)、无遥测。

📅 收录: 2026-11-06 🔄 更新: 2026-11-06

这是什么?适合谁?

Brigade(spinabot/brigade,MIT,TypeScript)是一个自托管的个人多 Agent 运行时:它把一群 AI Agent 组成一支有「组织架构图」的班组(crew/pride),全部 Agent 共享同一个长期记忆引擎 Tideline(带来源作用域、记忆衰减、关键词+向量混合召回),一个 Agent 学到的东西整组都能用。

它的定位口号是「Your personal intelligence, built enterprise-grade」——用企业级技术(权限门控、密钥本地 0600 存储、无遥测、可自托管 Convex 后端)做个人可负担的 Agent 生态。同一套班组可以跑在树莓派或服务器上;无账号、无中间 SaaS,API 密钥永远留在你自己的机器上。

核心能力(来自官方 README,2026-11-06 核验):

  • 任意模型:Anthropic、OpenAI、Gemini、OpenRouter、Groq、Cerebras、xAI、DeepSeek、Mistral、本地 Ollama 或任何 OpenAI 兼容端点,会话中途可换模型不丢上下文(Carrow 跨模型连续性)
  • 无 API Key 也能跑:可直接用你的 Claude / ChatGPT / Copilot 订阅登录,或复用 Claude Code / Codex CLI 的已有登录
  • 多渠道接入:WhatsApp、Telegram、Slack、Discord、iMessage、BlueBubbles,以及默认的终端 TUI
  • 1000+ 应用连接器(内置 Composio):Gmail、Notion、Calendar、Linear、GitHub 等
  • 文档读写:发 PDF / Office / 图片 / 音视频给班组,它能理解并生成或编辑 Word、Excel、PowerPoint、PDF 回传
  • MCP 双向:brigade mcp 把长期记忆暴露给任何 MCP 客户端,也能接入外部 MCP 服务器
  • 常驻运行:headless WebSocket 网关 + 崩溃监督器 + cron 任务 + OS 服务安装

适合谁:想要一个长期演进、数据不出本机的私人 Agent 班组的开发者与重度 AI 用户;想从终端统一调度多个模型和频道的极客;需要跨渠道(IM + 终端)访问同一套记忆的个人。

不适合谁:只想网页聊天不想碰终端的轻度用户;需要企业级多租户/审计合规的团队(它是「个人」运行时)。

准备工作

  1. Node.js 22.12+(官方安装脚本会顺手装好,也可自备)
  2. 至少一个模型来源:API Key(Anthropic/OpenAI/Gemini 等)、本地 Ollama,或一个 Claude/ChatGPT/Copilot 订阅
  3. (可选)想接 IM 渠道:对应平台的机器人凭据;想用 Composio 连接器:Composio 账号
  4. 成本:Brigade 本体 MIT 开源免费;真实成本是 LLM API 调用费(或你的订阅额度)+ 自托管机器

快速上手:5 步跑起你的第一支班组

Step 1 — 安装

# macOS / Linux(自动处理 Node 依赖)
curl -fsSL https://brigade.spinabot.com/install.sh | sh
# Windows PowerShell
irm https://brigade.spinabot.com/install.ps1 | iex
# 已有 Node 22.12+ 可直接
npm i -g @spinabot/brigade

Step 2 — 引导配置:运行 brigade onboard,向导五步走:(0) 存储模式(文件系统或自托管 Convex)→ (1) 选 provider → (2) 接入方式(粘 API Key / 订阅登录 / 复用 CLI 登录 / 连本地 Ollama)→ (3) 选默认模型 → (4) 选网页搜索后端(有免 Key 选项)。

Step 3 — 启动常驻网关

brigade gateway run

班组、频道、cron 任务都活在这个网关里;也可 brigade service install 装成系统服务开机自启。

Step 4 — 打开终端聊天:brigade tui 启动无闪烁的终端聊天界面。

Step 5 — 第一个任务:直接让它干一件需要跨会话记忆的事,比如:

记住我正在做一个叫 Astro 的站点重构,之后所有对话里提到"那个项目"都指它。
帮我从这封 Gmail 里提取待办并写进 Notion。

预期结果:Agent 完成任务后,这些事实进入 Tideline 长期记忆;下次新开会话问「我在忙什么项目」,无需重复交代。

初级用法

  • brigade agent spawn:创建带独立人设、凭据与记忆的子 Agent,按组织架构图决定谁能跟谁说话
  • brigade channel:把班组接进 WhatsApp/Telegram/Slack 等渠道,从 IM 里指挥同一套 Agent
  • brigade cron:给班组排定时任务(如每天早上汇总日历+邮件生成简报)
  • 文件投喂:终端里直接拖附件(brigade attach),PDF/Office/音视频都能被理解

高级玩法

  • Carrow 跨模型连续性:一个任务中途从 Claude 切到 GPT 再切到本地 Ollama,对话线程不断
  • 自托管 Convex 后端:默认是 ~/.brigade/ 下的文件系统模式;要更强的检索与静态加密时切到自托管 Convex
  • brigade bloody benchmark(v1.9.0+):一条命令把你的班组「扔到开放互联网」接受陌生人 3 点钟的poke 测试——经 HTTPS 隧道(默认 Cloudflare,也支持 bore/frp/sish)暴露班组,密钥隐形随行,闯入者一律 401;日常按钮版叫 brigade expose / brigade expose stop
  • 人检自我改进:self-improvement 机制由人工门控(human-gated),班组可以提议改进自己的技能但需你批准
  • Anti-slop 质量门:内置反套话质量关卡,压住模型输出的模板味

小技巧

  1. 密钥全在 ~/.brigade/(权限 0600),rm -rf ~/.brigade 即可彻底清场——迁移/销毁都干净
  2. npm 全局装报 EACCES 时别 sudo:用官方 curl 安装脚本(用户级私有运行时)或把 npm prefix 指到用户目录
  3. 不想配搜索后端就选免 Key 选项,开箱即用
  4. 订阅登录(Claude/ChatGPT/Copilot)适合零 Key 起步,跑通后再补 API Key 获得更稳的并发
  5. brigade mcp 把班组记忆挂给 Claude Code / Cursor 等 MCP 客户端,等于给自己的编码 Agent 外挂一层长期记忆

进阶学习建议

先把「组织架构图 + 子 Agent 隔离」吃透:用 brigade agent spawn 建一个调研 Agent + 一个执行 Agent,用 org/pride 层级限制执行 Agent 只能接收调研 Agent 的产出——这是 Brigade 区别于单 Agent 聊天工具的核心抽象(见 README「Org / Pride hierarchy」节)。其次研究 Tideline 的三个机制:origin scoping(记忆记来源)、decay(记忆衰减)、hybrid recall(关键词+向量混合召回),试着自己设计「哪些事实值得进长期记忆」。最后把 brigade expose 隧道与 bloody benchmark 跑一遍,实测你的权限门控是否挡得住陌生人访问;再把 cron + 渠道组合成一条「每早 8 点 Telegram 推送昨日邮件摘要」的真实流水线。

常见踩坑

  1. npm 全局安装权限报错(EACCES / permission denied):默认全局目录需要管理员权限。解法:用官方 curl/irm 安装脚本(自建用户级运行时),或 npm config set prefix ~/.npm-global 后把 ~/.npm-global/bin 加进 PATH,不要 sudo。
  2. 网关没起就开 TUI:班组、频道、cron 都住在 brigade gateway run 的常驻网关里,网关不在跑时定时任务与 IM 渠道全部失灵。先 brigade gateway run(或 brigade service install),再聊天。
  3. 订阅登录后并发受限:用 Claude/ChatGPT/Copilot 订阅登录时,速率受订阅本身限制,多 Agent 并行容易撞限流。重度多 Agent 场景换成正式 API Key。
  4. 记忆没被召回:Tideline 有衰减机制,太久没用且权重低的事实可能召回弱;把关键事实显式让 Agent「记住」,并注意 origin scoping——某来源作用域下的记忆不会跨作用域乱窜。
  5. IM 渠道收不到消息:适配器要求对应平台机器人凭据配置正确(token/手机号绑定等);排查先看网关日志,再看 brigade channel 的配对状态(pairing)。
  6. Windows 下脚本执行策略拦截 install.ps1:PowerShell 需允许远程签名脚本(Set-ExecutionPolicy RemoteSigned -Scope CurrentUser),或改用 npm 直装路线。

权限与安全要点

  • 密钥存储:~/.brigade/ 下 mode 0600,本站未实测但官方在 README 明示;彻底清除即 rm -rf ~/.brigade
  • 特权动作门控:需要授权的敏感操作会等待你批准(privileged actions wait for your approval),默认不静默执行
  • 暴露面:brigade expose / bloody benchmark 是唯一对公网开口的功能,默认 Cloudflare 隧道 + 隐形密钥,未获密钥的访问者 401;不用时 brigade expose stop 关闭
  • 数据流向:模型调用直连 provider,无遥测上报;Composio 连接器的授权数据走其官方服务,用哪些连接器由你决定
  • 订阅登录凭据:复用 Claude / ChatGPT / Copilot 登录态时,凭据仍在本机,不经过 Brigade 服务器

常见问题 FAQ

Q1: 没有任何 API Key 能用吗?

A: 可以。用 Claude / ChatGPT / Copilot 订阅登录,或复用已登录的 Claude Code / Codex CLI 登录,也能接本地 Ollama(完全离线)。

Q2: 我的数据会经过第三方吗?

A: 默认不。密钥与数据在 ~/.brigade/ 本地(0600),无遥测;模型调用直连你选的 provider。唯一例外是你主动用 brigade expose/bloody benchmark 开隧道时,流量走你配置的隧道(默认 Cloudflare)。

Q3: 和直接用 Claude Code / Codex 有什么区别?

A: 那些是单机编码 Agent;Brigade 是多 Agent 运行时——强调组织架构、共享长期记忆、IM 渠道接入、常驻网关与 cron。你也可以反过来,用 brigade mcp 把 Brigade 的记忆喂给 Claude Code。

Q4: 树莓派真能跑?

A: 官方明说同一班组可跑在树莓派或服务器,默认文件系统模式很轻;注意模型推理仍走远程 API,本地算力需求主要在网关本身。

Q5: 企业团队能用吗?

A: 定位是「个人」智能。企业级特征(数据主权、密钥治理、无遥测)都在,但多租户、审计、SSO 这类团队功能不是它的目标场景。

参考链接


最后更新:2026-11-06 · 作者:MagicNetWorld · 基于公开资料整理,关键数据经 GitHub API 独立实测核验,AI 辅助生成

📊 评分与标签

核验口径:已按现行口径通过,待按新证据契约复核

评分说明

总分 8.1/10 · P_优选

核验日期:2026-11-06。评价对象是自托管个人多 Agent 运行时 Brigade(spinabot/brigade,MIT,TypeScript,官网 brigade.spinabot.com),评价依据为官方 README、npm 包信息与 GitHub 公开仓库指标。按「个人多 Agent 运行时(生态/基础设施视角)」评价,不按 Agent 智能水平打分。

评分依据可追溯至公开来源,每项分数都有明确理由与数据支撑;本站未在本机部署 Brigade,运行行为描述均来自官方 README。

📊 可观测社区指标(采集日期:2026-11-06)

  • GitHub API:11,370 stars、81 forks、43 open issues,仓库未归档,MIT,主语言 TypeScript。
  • pushed_at 为 2026-11-04T07:20:01Z(北京时间 2026-11-04 15:20,隔日高活跃),创建于 2026-06-19,约 5 个月达 1.14 万 star。
  • 官网 brigade.spinabot.com 为 README homepage 登记地址;npm 包 @spinabot/brigade 公开发布。

🤖 Agent 能力:1.6/2.0

多 Agent 运行时的核心抽象齐全:组织架构图治理的子 Agent(独立人设/凭据/记忆,org / pride 层级控制谁跟谁说话)、共享长期记忆 Tideline(origin scoping + decay + 关键词与向量混合召回)、会话中途换模型(Carrow 跨模型连续性)、常驻网关 + cron 自主循环、self-improvement 机制(human-gated,改进需人工批准)。文档读写(Word/Excel/PPT/PDF 生成与编辑)与文档理解超出一般运行时。

扣分两处:一是官方定位为「个人」运行时,团队级协作治理(多租户、审计)不在目标场景;二是记忆衰减/召回质量属算法宣传,本站未实测验证。

  • 竞品对比 1(OpenClaw 类单 Agent 框架):单 Agent 框架在「多 Agent 组织与共享记忆」上没有一等抽象;Brigade 的 org chart 是其差异化核心。
  • 竞品对比 2(AutoGen):AutoGen 侧重多 Agent 对话编排研究框架,Brigade 侧重心一个可日常使用的个人产品(IM 渠道、终端 TUI、订阅登录开箱即用)。

🖐️ 易用性:1.1/1.5

上手路径完整:官方 curl/PowerShell 一键安装(自动处理 Node 22.12+ 依赖)、brigade onboard 五步向导(含零 API Key 的订阅登录/CLI 登录复用/本地 Ollama 选项)、gateway run + tui 三命令跑通。终端优先,无浏览器依赖。

扣分:多 Agent + 网关 + 渠道 + 记忆引擎的组合面宽,配置项多,非终端用户基本无法使用;Windows 用户对 PowerShell 执行策略等有额外心智负担。

  • 竞品对比 1(Claude Code):Claude Code 单命令零配置即用;Brigade 要理解「网关/班组/记忆」三层概念后才能发挥价值。
  • 竞品对比 2(n8n 类可视化编排):n8n 拖拽即可建流程;Brigade 全终端操作,换来的是更强的数据主权与可编程性。

🔌 生态集成:1.7/2.0

生态覆盖是 Brigade 最强项:1000+ 应用连接器(内置 Composio)、WhatsApp/Telegram/Slack/Discord/iMessage/BlueBubbles 多渠道适配、MCP 双向(brigade mcp 暴露记忆给任意 MCP 客户端 + 接入外部 MCP 服务器)、十余家模型 provider + 任意 OpenAI 兼容端点、文件系统或自托管 Convex 双存储、隧道暴露(Cloudflare 默认,支持 bore/frp/sish 开源中继)。

扣分一处:连接器生态依赖 Composio 与各 IM 平台机器人政策,第三方治理与长期可用性未逐项核验。

  • 竞品对比 1(Letta/MemGPT):Letta 记忆系统强在 API 层;Brigade 记忆直接产品化进 IM 渠道与 MCP,个人可用性更完整。
  • 竞品对比 2(Dify):Dify 平台自带数百集成但托管优先;Brigade 自托管 + 数据不出本机(密钥 0600 本地存储、无遥测)主权更强。

👥 社区支持:1.3/1.5

5 个月 11,370 stars,增长速度在同品类里属第一梯队(Trendshift 徽章佐证热度);43 open issues 数量健康;pushed_at 隔日活跃、CI 徽章在 README 展示;npm 正式发包、双平台安装脚本、Table of contents 结构化 README 完整度高于平均。

扣分:项目很年轻(2026-06 创建),三方贡献规模、issue 响应质量与治理节奏未抽样核实。

  • 竞品对比 1(LangGraph):LangGraph 社区成熟度以年计,教程与第三方库厚度远胜;Brigade 胜在交付完整度而非社区厚度。
  • 竞品对比 2(AgentBox):同为 2026 新项目,Brigade 的 star 增速与文档投入明显更高一档。

💡 创新程度:1.4/1.5

三个设计点在同品类少见:把「订阅登录」当一等公民(无 API Key 用户可直接复用 Claude/ChatGPT/Copilot 订阅与 CLI 登录);bloody benchmark 把「暴露给陌生人实测」产品化成一条命令的压测入口(安全自证思路新颖);记忆引擎 Tideline 把 origin scoping 与 decay 做进默认层而非可选项。

扣分一处:多 Agent + 长期记忆的组合方向上已有 Letta、Mem0 等先行者,单点新颖性集中在工程组合而非原理创新。

  • 竞品对比 1(Mem0):Mem0 是记忆层独立产品;Brigade 把记忆捆绑进运行时整体,对个人用户少一次拼装。
  • 竞品对比 2(Eigent):Eigent 走消费级全家桶路线;Brigade 选择终端优先 + 数据主权,对同一问题的解法相反。

🔒 稳定性:1.0/1.5

治理健康:MIT、CI 流水线、隔日推送、崩溃监督器与 OS 服务安装等「长跑」设计都在。但项目仅 5 个月、v1.9.x 阶段,README 自述生态快速演进,无生产级稳定性承诺;bloody benchmark 的隧道暴露属高风险功能,安全边界依赖单密钥 401 拒绝设计,未经本站实测。

  • 竞品对比 1(Claude Code):厂商级发布与回滚体系;Brigade 社区项目靠治理纪律,稳定性承诺弱一档。
  • 竞品对比 2(Letta):Letta 已有托管服务兜底;Brigade 自托管意味着稳定性自己兜底。

评分依据可追溯至公开来源,每项分数均有明确理由和数据支撑。

🏷️ 标签说明

局限与声明

  • 本站未安装或运行 Brigade,全部运行语义来自官方 README;Tideline 召回质量、Carrow 连续性、bloody benchmark 安全性均未实测。
  • 「1000+ 连接器」为 README 经由 Composio 的宣传口径,单个连接器可用性未逐项核验。
  • 采集日期 2026-11-06,此后 stars、版本与功能可能变化;项目创建于 2026-06,仍处快速演进期,评分为时点判断。

来源核实

  • ✅ 已验证: GitHub API spinabot/brigade — 2026-11-06 实测,stars/forks/issues/pushed_at/license/homepage 与引用一致
  • ✅ 已验证: Brigade README(raw) — 2026-11-06 抓取,安装五步/Features/CLI 结构逐项核对
  • ✅ 已验证: npm @spinabot/brigade — 官方登记的发布渠道(README 徽章)
  • ⚠️ 未实测: brigade.spinabot.com 站点与安装脚本行为 — 采集侧曾报 HTTP 200(2026-10-07),本站本轮未重复抓取正文内容

同分类推荐

开源框架 分类下的其他 Agent