Agent Network — 多 Agent,一行命令

把你的 Claude、Codex、Grok 拉进同一张网 —— 一行命令,互相派活。

4 个 Runtime ×ばつ 8 家 LLM 厂商,本地优先,跑在你自己的硬件上。Agent 之间通过 MCP 自动发现、流式协作、共享上下文。Apache 2.0 开源。

License anet npm version agent-node npm version commhub-server npm version dashboard npm version npm downloads Docs Changelog anet QA (v0) GitHub stars

📖 文档 · 📦 NPM · 💬 Discussions · 💚 微信群

English · 中文

# 装一个全局包
npm install -g @sleep2agi/agent-network
# 终端 1 —— 起 Hub(保持开着)
anet hub start
# 监听 http://127.0.0.1:9200,SQLite 在 ~/.commhub/commhub.db
# 自动创建默认账号:admin / anethub(公网部署务必先 anet passwd)
# 终端 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 自动发现彼此并协作。

anet upgrade # 一键把 4 个包升到 npm @latest
anet project restart # 重启 cwd 节点接新版

完整跨版本迁移参考 升级指南。

_{前置:Node.js ≥ 22.13.0(@inquirer/prompts 等依赖要求;老版本会触发 EBADENGINE warnings,不影响安装)。}

• 一个 CLI,四种 Runtime。 Claude Code CLI / Claude Agent SDK / Codex SDK / Grok Build ACP 同台运行,按角色挑最合适的。
• 八家 LLM,一个开关切换。 Anthropic / MiniMax / DeepSeek / GLM / Kimi / 书生 InternLM / 小米 MiMo / OpenRouter 走 ANTHROPIC_BASE_URL 一键路由;OpenAI 走 codex-sdk、xAI Grok 走 grok-build-acp。
• 本地跑,跨服务器也跑。 Hub 默认绑 127.0.0.1;改 0.0.0.0 绑公网 IP,多台云服务器 / 多个工位的 Agent 都能加入同一个 Hub。SQLite 全程在 Hub 那台机,不用注册账号、不用登云、零遥测。
• Mesh 派活开箱即用。 Agent 之间通过 17 个 MCP 工具自动发现 + 互相派活,不用写编排逻辑。
• 自带 Web Dashboard。 7 大页(Overview / Nodes / Tasks / Messages / Chat / Admin / Settings)+ 实时节点拓扑图,跑在 localhost:3000。
• 和 LangGraph / AutoGen / CrewAI 不一样: anet 是 npm 包,零 Python 依赖;本地优先而非 SaaS;多厂商不锁定而非默认 OpenAI;人 + Agent 同台通过 Dashboard Chat 协作。

_{对照各项目公开文档,不构成性能 benchmark,仅说明定位差异。}

跑在 localhost:3000(Next.js 16),7 大页面:Overview / Nodes / Tasks / Messages / Chat / Admin / Settings —— 含实时节点拓扑图(mesh / ring 双视图,连线按消息频度分级)、人机同台 Chat、任务流可视化(父子任务 chain)。

启动后浏览器打开 localhost:3000 即见;完整截图与交互演示 → https://anet.sh。

┌──────────┐ send_task ┌────────────────┐ SSE push ┌──────────┐
│ Agent A │ ────────────→ │ CommHub │ ───────────→ │ Agent B │
│ │ ←──────────── │ Server (:9200) │ ←─────────── │ │
└──────────┘ reply └───────┬────────┘ report └──────────┘
 │
 ┌────────┴────────┐
 │ Dashboard │
 │ (:3000) │
 └─────────────────┘

flowchart LR
 A[Agent A] -- send_task --> H[(CommHub<br/>Server :9200)]
 H -- SSE push --> B[Agent B]
 B -- reply --> H
 H -- report --> A
 H --- D[Dashboard :3000]
 H -.- DB[(SQLite<br/>~/.commhub)]

节点接入流程(从 0 到上线 30 秒):

flowchart LR
 C0[anet node create my-bot] --> C1{选 runtime}
 C1 --> C2{选 provider}
 C2 --> C3[填 API key]
 C3 --> C4[anet node start my-bot]
 C4 --> C5[SSE connected ✓ 上线]

• MCP Streamable HTTP(/mcp)—— Agent / Claude Code / Codex 接入点
• SSE 推送(/events/:alias)—— Hub 实时把任务推给 Agent
• REST API(/api/*)—— Dashboard、管理、监控、审计日志
• 17 个 MCP 工具 —— send_task / get_task / send_reply / report_status / get_all_status / ...

📖 架构详解 → https://anet.sh/guide/architecture

每个节点选一种,同一个 Hub 上自由混搭。

先安装并登录 Grok Build CLI:

curl -fsSL https://x.ai/cli/install.sh | bash
grok

再创建并启动 Grok 节点:

anet node create grok-demo --runtime grok-build-acp
anet node start grok-demo

稳定支持:SSE 收任务、Grok ACP 执行、grokSession 持久化/恢复、回复 CommHub,以及 wrapper 层显式派发任务。当前边界:Grok 原生 MCP tool injection 仍按 preview 处理,CommHub 派发由 agent-node wrapper 执行。

📖 Grok Build 运行时说明 → docs/grok-build-runtime.md

📖 Runtime 详解 → https://anet.sh/guide/runtimes

claude-agent-sdk 本质就是 Anthropic Messages 客户端,任何 Anthropic 兼容 endpoint 都能跑。anet node create 内置 VENDORS 供应商列表里的每一项都 verified-with-real-call(跑通真实 API 才进列表);列表外的 provider 走「自定义」custom 接入。

📖 各家 Key / 模型 / 接入 → https://anet.sh/guide/multi-model

Apache-2.0,已发 npm。anet upgrade 一键全升 latest。

CLI 第一次用到 hub 和 node 时会自动用 bunx / npx 拉对应包,全局只需装一个 agent-network。Dashboard 是独立 repo:sleep2agi/agent-network-dashboard。

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 测试矩阵

4 个包均 Apache 2.0,Stable on npm latest,发布节奏与 changelog 见 anet.sh/changelog。次要版本之间 API 仍可能变动,请固定依赖版本。项目 2026年05月11日 开源,作者每天自用、持续打磨。

已稳定 + E2E 通过

• anet hub start / hub dashboard / login / register / whoami / logout
• anet node create / start / stop / delete / ls / logs
• claude-agent-sdk —— 经 Docker E2E 全链路验证 2 家 Provider:书生 Intern + MiniMax
• 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
• grok-build-acp runtime —— 正式接入,本地 grok agent stdio + Agent Client Protocol,复用本机 Grok 登录态;未上 E2E
• anet network create + 跨用户网络共享 —— 代码已合并,未做 E2E
• anet channel add telegram | wechat | feishu —— Telegram 路径已跑通,其他未跑

未实现 / Legacy

• anet license / anet activate —— v0.6 legacy 命令,Apache 2.0 OSS 后不再需要;命中 license_expired 见 troubleshooting
• 没有官方托管 Hub —— 产品方向是 Apache 2.0 + 自部署 + 课程 / 服务咨询,不做 SaaS;生产部署走 Docker 或 生产部署

安全提示 —— 每个 Agent 节点默认带 dangerouslySkipPermissions: true 启动,调工具不会跳确认。请把 Agent 当成不可信代码处理,用一次性工作目录跑,别在 $HOME 下直接跑。详见 SECURITY.md。

欢迎 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。

扫码加入 Agent Network 社区交流群 —— 设计讨论、排查问题、版本动态:

Agent Network 微信群

二维码每 7 天轮换一次,过期了到 https://anet.sh/community/wechat-group.jpg 拿最新版(地址不变)。

英文 / 异步用户:GitHub Discussions。

• anet.sh —— 完整文档站 · 上手指南 · 架构概览 · Runtime · Changelog
• 📚 研发流程 SOP —— 以 Issue 为中心的 AI-Native 研发迭代流程
• @sleep2agi on npm —— 包索引
• Discussions · Issues

由 @sleep2agi 构建和维护。如果你的团队在用、想资助开发或赞助某个 feature,开一个 sponsor 标签的 issue,欢迎聊。

Apache-2.0 © 2025–2026 sleep2agi contributors