Commhub Server

为什么用 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] 公网自部署有风险，先看完这一段再开放安全组。 当前默认配置只为本机使用优化：

1. 默认账号 admin / anethub —— 任何公网部署都必须立刻 anet passwd 改密，否则被人扫到端口就能进
2. Hub 默认绑 127.0.0.1 —— 公网模式（--host 0.0.0.0）必须配反代（Caddy / Nginx）+ TLS，不要把 9200 / 3000 直接挂公网
3. 多租户隔离不完整 —— 当前任意有效 token 可读全局任务 / 订阅其他 alias SSE，多用户共享 Hub 之前先 review 你信谁
4. 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。

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 详解 → https://anet.sh/guide/runtimes

已验证 Provider

claude-agent-sdk 本质就是 Anthropic Messages 客户端，任何兼容 endpoint 都能跑。

📖 各家 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 / logout
• anet node create / start / stop / delete / ls / logs
• claude-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-cli runtime —— 本机能跑，未自动化
• codex-sdk runtime —— 单元测试通过，真实 OAuth 流程未上 CI
• anet network create + 跨用户网络共享 —— 代码已合并，未做 E2E
• anet 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。

你的项目用了 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