Commhub Server
CommHub Server — AI Agent communication hub with MCP protocol, multi-network isolation, user auth, and 18 MCP tools.
Ask AI about Commhub Server
Powered by Claude · Grounded in docs
I know everything about Commhub Server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Agent Network
本地优先的多 Agent 协作平台。一个 npm 包搞定 Hub、Web Dashboard、N 个 Agent —— 全部跑在你自己的机器上，可选共享到局域网。
多 Agent，一行命令。让 Claude / GPT / MiniMax / DeepSeek / GLM / Kimi / 书生 在你电脑上一起干活。
📖 文档 · 📦 NPM · ⭐ GitHub · 💬 Discussions · 💚 微信群
English · 中文
为什么用 Agent Network
- 一个 CLI，三种 Runtime。 Claude Code CLI / Claude Agent SDK / Codex SDK 同时跑在一个 Hub 上，按角色挑最合适的。
- 七家 LLM，一个开关切换。 Anthropic、OpenAI、MiniMax、DeepSeek、智谱 GLM、月之暗面 Kimi、书生 InternLM —— 通过
ANTHROPIC_BASE_URL一键路由。 - 本地跑得动，跨服务器也跑得动。 Hub 默认绑
127.0.0.1纯本机；改成0.0.0.0绑公网 IP，多台云服务器 / 多个工位的 Agent 都能加入同一个 Hub，SSE 实时双向。SQLite 数据全程在 Hub 所在那台机器，不用注册账号、不用登云、零遥测。 - Mesh 派活开箱即用。 Agent 之间通过 18 个 MCP 工具（
get_all_status/send_task/get_task…）自动发现 + 互相派活，不需要你写编排逻辑。 - 自带 Web Dashboard。 Chat / Nodes / Tasks / Messages / Networks / Logs / Admin —— Next.js + 4 套主题，跑在
localhost:3000。
[!IMPORTANT] 公测阶段。 作者已自用两个月，第一个开源稳定版预计 2026 年 6 月上旬 出。现在主要是作者自用慢慢打磨，欢迎试用 + 提意见。次要版本之间 API 仍可能变动，请固定依赖版本。
安全提示。 每个 Agent 节点默认带
dangerouslySkipPermissions: true启动，调工具不会跳确认。请把 Agent 当成不可信代码处理 —— 用一次性工作目录跑，别在$HOME下直接跑。详见 SECURITY.md。
[!WARNING] 公网自部署有风险，先看完这一段再开放安全组。 当前默认配置只为本机使用优化：
- 默认账号
admin / anethub—— 任何公网部署都必须立刻anet passwd改密，否则被人扫到端口就能进- Hub 默认绑
127.0.0.1—— 公网模式（--host 0.0.0.0）必须配反代（Caddy / Nginx）+ TLS，不要把 9200 / 3000 直接挂公网- 多租户隔离不完整 —— 当前任意有效 token 可读全局任务 / 订阅其他 alias SSE，多用户共享 Hub 之前先 review 你信谁
- tmux 控制面 —— 在 open mode（无 token）下可远程读写终端，等同 RCE。生产环境务必设置
COMMHUB_AUTH_TOKEN并把 tmux 接口绑 localhost完整安全审计 + 修复清单：
docs/open-source-security-risk-report.md（v0.6.1 stable 会修掉 P0）
30 秒上手
# 装一个全局包
npm install -g @sleep2agi/agent-network
# 终端 1 —— 起 Hub（保持开着）
anet hub start
# 监听 http://127.0.0.1:9200
# SQLite 在 ~/.commhub/commhub.db
# 自动创建默认账号：admin / anethub
# 终端 2 —— 起 Dashboard（保持开着）
anet hub dashboard
# 浏览器访问 http://localhost:3000
# 终端 3 —— 登录 + 创建 + 启动 Agent
anet login --username admin --password anethub
anet node create my-bot # 两步交互：选 runtime → 选 provider → 填 API key
anet node start my-bot # 等到 "SSE connected" 即就绪
从 Dashboard 的 Chat 面板派任务即可。再起一个节点让第一个去派活，两个 Agent 会通过 MCP 自动发现彼此并协作。
📖 完整指南 → https://anet.sh/guide/getting-started
一键 Demo
export MINIMAX_KEY=sk-cp-xxx
# 6 角色 9 步辩论赛，约 10 分钟
anet demo debate --topic "AI 创造的岗位是否比消灭的多"
# 4 角色社媒内容工厂，约 3 分钟
anet demo socialmedia --topic "AI 时代如何提升专注力" --platform xiaohongshu
每个 demo 跑在独立 network 里，跑完自动清场，不会污染 default network。
套件包
稳定版，Apache-2.0，已发 npm。
| 包 | 版本 | 角色 |
|---|---|---|
@sleep2agi/agent-network | 2.1.0 | anet CLI —— Hub / Dashboard / Agent / Demo 启动器 |
@sleep2agi/commhub-server | 0.6.0 | MCP + REST + SSE 通信中枢（默认 SQLite，可换 PostgreSQL） |
@sleep2agi/agent-network-dashboard | 0.3.0 | Web Dashboard —— Next.js 16，4 套主题，Chat / Nodes / Tasks / Networks / Logs / Admin |
@sleep2agi/agent-node | 2.3.0 | Agent 运行时 —— Claude Code CLI / Claude Agent SDK / Codex SDK |
CLI 第一次用到 hub 和 node 时会自动用 bunx / npx 拉取包，你只需要全局装一个。
架构
┌──────────┐ send_task ┌────────────────┐ SSE push ┌──────────┐
│ Agent A │ ────────────→ │ CommHub │ ───────────→ │ Agent B │
│ │ ←──────────── │ Server (:9200) │ ←─────────── │ │
└──────────┘ reply └───────┬────────┘ report └──────────┘
│
┌────────┴────────┐
│ Dashboard │
│ (:3000) │
└─────────────────┘
- MCP Streamable HTTP（
/mcp）—— Agent / Claude Code / Codex 接入点 - SSE 推送（
/events/:alias）—— Hub 实时把任务推给 Agent - REST API（
/api/*）—— Dashboard、管理、监控、审计日志 - 18 个 MCP 工具 ——
send_task、get_task、send_reply、report_status、get_all_status、…
📖 架构详解 → https://anet.sh/guide/architecture
三种 Runtime
每个节点选一种，同一个 Hub 上自由混搭。
| Runtime | 工作方式 | 适合场景 | 鉴权 |
|---|---|---|---|
claude-code-cli | spawn 本地 claude CLI 子进程 | 复用 Claude Pro 订阅，享 Claude Code 全套工具 | 本地 claude 已登录 |
claude-agent-sdk | 编程式调 Anthropic 兼容 API | Anthropic / MiniMax / DeepSeek / GLM / Kimi / 书生 等（通过 ANTHROPIC_BASE_URL） | API key |
codex-sdk | OpenAI @openai/codex-sdk | 写代码 / 跑命令 | codex auth login 或 OPENAI_API_KEY |
📖 Runtime 详解 → https://anet.sh/guide/runtimes
已验证 Provider
claude-agent-sdk 本质就是 Anthropic Messages 客户端，任何兼容 endpoint 都能跑。
| Provider | 状态 | ANTHROPIC_BASE_URL |
|---|---|---|
| Anthropic | verified | https://api.anthropic.com |
| MiniMax | verified | https://api.minimaxi.com/anthropic |
| DeepSeek | verified | （官方 Anthropic 兼容 endpoint） |
| 智谱 GLM | verified | （open.bigmodel.cn Anthropic 适配） |
| 月之暗面 Kimi | verified | （platform.moonshot.cn Anthropic 兼容） |
| 书生 InternLM | verified | https://chat.intern-ai.org.cn/anthropic |
OpenAI（通过 codex-sdk） | verified | n/a —— OpenAI 原生 |
| OpenRouter / 自定义 Anthropic 兼容 | dev 跑通，无 E2E | 自填 base URL + token |
📖 各家 Key / 模型 / 预设 → https://anet.sh/guide/multi-model
仓库结构
agent-network/ anet CLI (npm: @sleep2agi/agent-network)
agent-node/ Agent 运行时 (npm: @sleep2agi/agent-node)
server/ CommHub Server (npm: @sleep2agi/commhub-server)
channel/ Claude Code Channel 插件
docs-site/ VitePress 源码（https://anet.sh）
docs/ 设计文档 / RFC / 演进日志
tests/ Docker 测试矩阵
Dashboard 是独立 repo：sleep2agi/agent-network-dashboard。
状态 & 已知限制
已稳定 + E2E 通过
anet hub start/hub dashboard/login/register/whoami/logoutanet node create / start / stop / delete / ls / logsclaude-agent-sdk+ 上面六家 Provider（Docker E2E）- Dashboard Chat —— markdown 渲染、乐观回显、来源标签、错误兜底、历史持久
- 多 Agent 互派（
get_all_status+send_task+get_task） - 局域网共用 Hub（
--host 0.0.0.0）
能跑但缺 E2E 回归
claude-code-cliruntime —— 本机能跑，未自动化codex-sdkruntime —— 单元测试通过，真实 OAuth 流程未上 CIanet network create+ 跨用户网络共享 —— 代码已合并，未做 E2Eanet channel add telegram | wechat | feishu—— Telegram 路径已跑通，其他未跑
未实现
anet license/anet activate—— 给未来付费版预留的占位命令- 云托管 Hub / 公开 Demo 站点 —— 当前只支持本地 / 局域网
贡献
欢迎 PR。环境搭建、分支命名、测试矩阵详见 CONTRIBUTING.md。提交即代表同意 Code of Conduct。
最快帮上忙的方式：跑一遍上面的 30 秒上手，把任何"咦？"的地方发到 Discussions 或 Issues。
安全
发现漏洞？别开公开 issue。请用 GitHub Security Advisories 私下报告。完整披露流程和威胁模型（特别是 dangerouslySkipPermissions 和局域网 Hub 暴露相关）见 SECURITY.md。
生态项目
基于 Agent Network 构建 / 用 anet 提升生产力的项目 —— 完整列表 https://anet.sh/ecosystem。
| 项目 | 是什么 |
|---|---|
| 🌀 Agent Network | 你正在看的这个项目本身 —— dogfood：agent-network 也是用 agent-network 开发的 |
| 📑 PaperScope.ai | 智能 AI 论文发现与解读平台 |
| 📊 AI Insight | 每日更新的 AI 行业研报与高信噪比资讯聚合 |
你的项目用了 anet？提个 PR 到 docs-site/docs/ecosystem.md 或发到 Discussions。
资源
- anet.sh —— 完整文档站
- 上手指南 —— 已 E2E 验证的全链路
- 节点 Runtime —— Claude Code CLI vs Agent SDK vs Codex
- 架构概览 —— MCP / SSE / REST / SQLite schema
- @sleep2agi on npm —— 包索引
- GitHub Discussions —— 问答 / 想法
- GitHub Issues —— bug 反馈
加入社群 / Join us
扫码加入 Agent Network 社区交流群 —— 设计讨论、排查问题、版本动态：
二维码每 7 天轮换一次，过期了到 https://anet.sh/community/wechat-group.jpg 拿最新版（地址不变）。
英文 / 异步用户：GitHub Discussions。
鸣谢
由 @sleep2agi 构建和维护。如果你的团队在用、想资助开发或赞助某个 feature，开一个 sponsor 标签的 issue，欢迎聊。
License
Apache-2.0 © 2025–2026 sleep2agi contributors