项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 11371
使用教程
环境要求
- macOS / Linux(安装脚本无需 sudo)
- Node 22.12+(安装脚本会在缺失时自动安装)
- 如需接入 Telegram,需先在 @BotFather 创建机器人并拿到 API token
- 需要 Claude / ChatGPT / Copilot 订阅登录,或自备 API key,或本地 Ollama
安装与启动步骤
-
1安装 Brigade
执行官方安装脚本,自动安装 Node 22.12+ 后再装 Brigade,全程无需 sudo。
curl -fsSL https://brigade.spinabot.com/install.sh | sh -
2启动交互界面
运行 brigade 进入快速聊天 TUI,确认命令已可正常调用。
brigade -
3完成初始化配置
运行 onboard,选择模型供应商、粘贴 API key(或扫描本地 Ollama),并选择默认模型。
brigade onboard -
4添加 Telegram 渠道
在网关机器上添加 Telegram 渠道,按提示粘贴从 @BotFather 获取的机器人 token。
brigade channels add --channel telegram -
5重启网关加载渠道
重启网关使新添加的渠道配置生效,默认监听 7777 端口。
brigade gateway restart -
6审批配对成为 owner
私聊机器人获得一次性配对码,在网关机器上用 CLI 审批;首次审批即为所有者。
brigade pairing approve <code> --channel telegram
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
BRIGADE_STATE_DIR | 否 | 指定替代的状态目录,默认 ~/.brigade | /your/path/.brigade |
BRIGADE_CONFIG_PATH | 否 | 指定替代的配置文件路径 | /your/path/brigade.json |
BRIGADE_PORT | 否 | 网关监听端口,默认 7777 | 7777 |
BRIGADE_PROFILE | 否 | 使用命名 profile,目录为 workspace-<profile>/ | work |
BRIGADE_MODE | 否 | 存储模式,可选 filesystem 或 convex | filesystem |
BRIGADE_CONVEX_URL | 否 | Convex 部署地址,设置后隐含启用 convex 模式 | https://your-deployment.convex.cloud |
如何确认成功
运行 brigade 后出现快速聊天 TUI,并可正常对话;网关默认监听 7777 端口即视为启动成功。
常见问题
Q:没有 API key 能用吗?
A:可以。README 说明可用 Claude、ChatGPT 或 Copilot 订阅登录,若已登录 Claude Code 或 Codex CLI 可直接复用其登录状态,无需浏览器重新认证。
Q:没有安装 Node 怎么办?
A:官方安装脚本会在检测不到时自动安装 Node 22.12+,无需手动准备环境,也不需要 sudo。
Q:如何彻底清空 Brigade 的全部数据?
A:所有状态都存放在 ~/.brigade/ 下,执行 rm -rf ~/.brigade 即可完全清除,包括配置、记忆、技能与会话记录。
Q:Telegram 机器人为什么不能让第一个发消息的人成为 owner?
A:所有权在网关侧建立,必须能访问网关机器才能完成首次审批,因此仅发送 /start 不会自动成为所有者。
注意事项
- API key 只保存在本机,不会发送给中间方,也不采集遥测数据。
- 所有状态、工作区与凭据都在 ~/.brigade/ 目录下,由你自己掌控。
- 配置文件为 brigade.json(JSON5 格式),写入时会保留 ${VAR} 密钥引用,并生成权限 0600 的轮转备份。
- 每个 Telegram 机器人或账号各自维护自己的 owner,互不影响。
核心亮点
- 企业级安全与治理:内置安全策略和审计功能,适合生产环境。
- 多模型兼容:支持 ChatGPT、Codex 等主流模型,灵活切换。
- TypeScript 原生:类型安全,对前端/全栈开发者友好。
不足之处
- 早期项目,文档和社区生态尚不完善。
- 功能边界较新,与成熟框架相比集成案例较少。
适用场景
- 企业内部自动化流程(如工单处理、数据整理)
- 构建自主研究助手或知识管理代理
- 需要严格安全合规的 AI 应用开发
替代项目
LangChain、AutoGen、CrewAI
上一篇:metaharness
下一篇:nl-veil
同类项目推荐
agentcad
开源
让 AI 直接建模,一句话生成 CAD 模型
CAD CLI and MCP server for AI agents
council-lab
开源
让四个 AI 替你辩论,决策更靠谱
Local-first AI decision workspace with four competing perspectives, human approval, ···
python-utcp
开源
让 AI 智能体直接调用任意 API,告别中间件,一个协议搞定工具集成。
Official python implementation of UTCP. UTCP is an open standard that lets AI agents···
persona-studio
开源
开会不用露脸,数字人替你去刷存在感。
AI persona avatars + virtual meetings for Claude Code (tmux split-panes + Ralph loop···
GenAI_Agents
开源
50+实战教程,从聊天机器人到多智能体系统,快速上手 AI 智能体开发。
50+ tutorials and implementations for Generative AI Agent techniques, from basic con···
mcp-dock
开源
一个命令管理 14 款 AI 工具的 MCP 配置,告别手改 JSON。
MCP Server & Config Manager for 14 AI Clients — Cursor, VS Code, Claude Code, Gemin···
mcp-google-map
开源
让 AI 智能体一键调用 Google Maps,实时获取地理数据并做出位置决策。
18 Google Maps tools and 3 Agent Skills for place search, routes, travel planning, a···
teleton-agent
开源
在 Telegram 里跑一个会自己操作 TON 链的 AI 代理
Teleton: Autonomous AI Agent for Telegram & TON Blockchain
MLE-agent
开源
读论文、写代码、做研究,一个助手全搞定
MLE-Agent: Your intelligent companion for seamless AI engineering and research. Int···
