Agent Network

本地优先的多 Agent 协作网络 —— 4 个 Runtime × 8 家 LLM 厂商，一行命令编排成一张 mesh。

Claude Code · Claude Agent SDK · Codex · Grok Build ACP 同台运行；agent 之间互派任务、流式协作、共享上下文，全部跑在你自己的硬件上。Apache 2.0 开源。

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

30 秒上手（首次安装）

前置：Node.js ≥ 22.13.0（@inquirer/prompts 等依赖要求；老版本会触发 EBADENGINE warnings）。

# 装一个全局包（拉 npm @latest，当前 agent-network 2.2.10）
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 自动发现彼此并协作。

已装 anet？升级到最新

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

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

下一步

跑完 30 秒上手之后：

📖 看文档 —— anet.sh/guide/getting-started 全链路教程 + 架构概览
💚 加微信群 —— 扫码进群设计讨论、版本动态、排查问题
⭐ Star 项目 —— 觉得有用就给个 Star，活跃度直接反映在 release 节奏上

为什么用 Agent Network

一个 CLI，四种 Runtime。 Claude Code CLI / Claude Agent SDK / Codex SDK / Grok Build ACP 同时跑在一个 Hub 上，按角色挑最合适的。
八家 LLM，一个开关切换。 Anthropic / MiniMax / DeepSeek / 智谱 GLM / 月之暗面 Kimi / 书生 InternLM / 小米 MiMo / OpenRouter —— 通过 ANTHROPIC_BASE_URL 一键路由（OpenAI 走 codex-sdk runtime、xAI Grok 走 grok-build-acp runtime, 另算）。
本地跑得动，跨服务器也跑得动。 Hub 默认绑 127.0.0.1 纯本机；改成 0.0.0.0 绑公网 IP，多台云服务器 / 多个工位的 Agent 都能加入同一个 Hub，SSE 实时双向。SQLite 数据全程在 Hub 所在那台机器，不用注册账号、不用登云、零遥测。
Mesh 派活开箱即用。 Agent 之间通过 17 个 MCP 工具（get_all_status / send_task / get_task …）自动发现 + 互相派活，不需要你写编排逻辑。
自带 Web Dashboard。 Overview / Nodes / Tasks / Messages / Chat / Admin / Settings 七大页 + 实时节点拓扑图（grid / ring 双视图，连线按消息频度分级）—— Next.js 16 + 4 套主题，跑在 localhost:3000。
和 LangGraph / AutoGen / CrewAI 不一样： anet 是 npm 包，零 Python 依赖；本地优先而非 SaaS 框架；多厂商不锁定而非默认 OpenAI；人 + Agent 同台通过 Dashboard Chat 协作而非纯程序编排。

anet vs 其他多 Agent 框架

维度	anet	LangGraph	AutoGen	CrewAI
部署模式	本地优先 + LAN/公网共享	Python 库	Python 库	Python 库
多 LLM 厂商	Anthropic / MiniMax / DeepSeek / GLM / Kimi / 书生 / 小米 MiMo / OpenRouter（走 `ANTHROPIC_BASE_URL`）+ OpenAI（`codex-sdk` runtime）+ xAI Grok（`grok-build-acp` runtime）	走 LangChain	主要 OpenAI / Azure	走 LangChain
Agent 间通信	MCP + SSE 中枢，自动发现	编程式 graph	group chat	hierarchy / sequential
人 + Agent 同台	✅ Dashboard Chat 同界面	n/a（纯程序）	n/a	n/a
部署形态	一个 npm 包	pip + 自写 server	pip + 自写 server	pip + 自写 server

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

Dashboard 预览

跑在 localhost:3000，Next.js 16，7 大页面：Overview / Nodes / Tasks / Messages / Chat / Admin / Settings。

_{Overview — 网络概览：在线 Agent / 任务统计 / 服务器健康}	_{Chat — 人和 Agent 同台对话，markdown 渲染 + Enter 发送 + 来源标签}
_{拓扑图 — 实时节点 mesh / ring 视图，连线按消息频度分级}	_{Task Flow — 任务派发 / 状态机 / 父子任务 chain 可视化}
_{Nodes — 节点详情 / runtime / model / 健康指标 / process telemetry}

架构

┌──────────┐   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

四种 Runtime

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

Runtime	工作方式	适合场景	鉴权
`claude-code-cli`	spawn 本地 `claude` CLI 子进程	复用 Claude Pro 订阅，享 Claude Code 全套工具	本地 `claude` 已登录
`claude-agent-sdk`	编程式调 Anthropic 兼容 API	Anthropic / MiniMax / DeepSeek / GLM / Kimi / 书生 / 小米 MiMo / OpenRouter 等（通过 `ANTHROPIC_BASE_URL`）	API key
`codex-sdk`	OpenAI `@openai/codex-sdk`	写代码 / 跑命令	`codex auth login` 或 `OPENAI_API_KEY`
`grok-build-acp`	本地 `grok agent stdio` + Agent Client Protocol	Grok Build 节点加入 Agent Network，复用本机 Grok 登录态	本地 `grok` 已登录

Grok Build 接入

先安装并登录 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

Provider 接入

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

Provider	接入方式	`ANTHROPIC_BASE_URL`
Anthropic Claude	内置 vendor · verified	`https://api.anthropic.com`
MiniMax	内置 vendor · verified	`https://api.minimaxi.com/anthropic`
小米 MiMo	内置 vendor · verified	`https://token-plan-cn.xiaomimimo.com/anthropic`
书生 Intern	内置 vendor · verified	`https://chat.intern-ai.org.cn`（裸域名，无 `/anthropic`）
OpenAI Codex（`codex-sdk`）	内置 vendor · verified	n/a —— `codex auth login`
DeepSeek / 智谱 GLM / 月之暗面 Kimi / OpenRouter / 自建	走 `custom` 供应商（不在内置列表，自行验证 endpoint + model id）	自填 base URL + `ANTHROPIC_AUTH_TOKEN`

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

套件包

稳定版，Apache-2.0，已发 npm。

包	版本	角色
`@sleep2agi/agent-network`	`2.2.10`	`anet` CLI —— Hub / Dashboard / Agent / Demo 启动器 + `anet hub stop` / `anet hub status` 子命令（v0.10.11 #200）+ `anet hub start` stderr inherit（#199 静默挂修）+ `grok-build-acp` per-node isolated cwd（#204 身份隔离）+ 小米 MiMo 5-model preset + envRef wizard-to-start 自动衔接（详见 changelog）
`@sleep2agi/commhub-server`	`0.8.4`	MCP + REST + SSE 通信中枢（SQLite）+ broadcast `channel_meta_json` sender 归属修（#194 hotfix）+ `meta.attachments` / `meta_json` 图片附件元数据 + `/api/server/:host/health` + `/api/server/:host/agents`
`@sleep2agi/agent-network-dashboard`	`0.5.6`	Web Dashboard —— Next.js 16，图片上传/粘贴发送（v0.10.9）+ 4 套主题 + Hero 3 网络节点前端 8/8 surface + Servers 面板 polish + 100+ 轮 typography & 圆角级联 polish
`@sleep2agi/agent-node`	`2.4.7`	Agent 运行时 —— Claude Code CLI / Claude Agent SDK / Codex SDK / Grok Build ACP + grok-build-acp 节点身份隔离（#204 per-node `.anet/nodes/<alias>/runtime-cwd/`）+ codex-sdk 图片输入 + Grok ACP 稳定化与工具状态泄漏清洗 + Grok delegate parser broaden

CLI 第一次用到 hub 和 node 时会自动用 bunx / npx 拉取包，你只需要全局装一个。

仓库结构

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 —— 经 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 —— 本机能跑，未自动化（v0.8.2 修了 session resume 默认丢失 bug，详见 changelog）
codex-sdk runtime —— 单元测试通过，真实 OAuth 流程未上 CI
grok-build-acp runtime —— v0.10.8 起正式接入（anet node create --runtime grok-build-acp），本地 grok agent stdio + Agent Client Protocol，复用本机 Grok 登录态；v0.10.11 preview chain 持续 polish 多节点身份隔离（#204），未上 E2E
anet network create + 跨用户网络共享 —— 代码已合并，未做 E2E
anet channel add telegram | wechat | feishu —— Telegram 路径已跑通，其他未跑

未实现

anet license / anet activate —— v0.6 legacy 命令，Apache 2.0 OSS 后不再需要；Hub 后向兼容仍创建 14 天 trial，命中 license_expired 见 troubleshooting
没有官方托管 Hub —— 产品方向是 Apache 2.0 + 自部署 + 课程 / 服务咨询，不做 SaaS；生产部署走 Docker 或生产部署

Important

当前 stable（Apache 2.0，4 个包均在 npm latest：agent-network 2.2.10 / agent-node 2.4.7 / commhub-server 0.8.4 / agent-network-dashboard 0.5.6）。v0.10.11 补齐 anet hub stop / anet hub status 子命令（#200，SIGTERM → 3s → SIGKILL 兜底，不用手动 lsof+kill）+ anet hub start stderr inherit（#199 静默挂修）+ grok-build-acp per-node isolated cwd（#204 节点身份隔离，跨节点 dispatch attribution 不再污染）+ commhub-server channel_meta_json broadcast sender 归属修（#194 hotfix）+ Grok delegate parser 3-layer broaden（#201）；v0.10.10 补齐小米 MiMo 5-model preset（mimo-v2.5-pro 默认 + v2.5 / v2-pro / v2-omni / v2.5-tts-voicedesign）+ envRef wizard-to-start 自动衔接（anet node create 完不用 export，start 自动 source .env）；v0.10.9 加 codex-sdk 图片输入 + commhub 附件 meta_json 元数据；v0.10.8 Grok Build ACP 正式接入: anet node create --runtime grok-build-acp、Grok ACP session 持久化/恢复、-32603 稳定化、以及 Grok 工具状态泄漏清洗。v0.10 系列从 Direct Runtime + Observability Foundations 起持续迭代，详见 changelog；项目 2026-05-11 开源。作者每天自用、持续打磨，欢迎试用 + 提意见。次要版本之间 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 直接挂公网
多租户隔离依赖 network scope —— v0.8 起已强制用户 / 节点按 network 访问；仍不要把互不信任的人放进同一个 network
tmux 控制面 —— 默认关闭；只有显式 COMMHUB_ENABLE_TMUX=1 才启用，生产环境必须配 admin 鉴权、反代 TLS 和最小暴露面

完整安全审计 + 修复清单：docs/open-source-security-risk-report.md（v0.8.0 / v0.8.1 已修掉 P0）

贡献

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

Star History

资源

anet.sh —— 完整文档站
上手指南 —— 已 E2E 验证的全链路
节点 Runtime —— Claude Code CLI vs Agent SDK vs Codex vs Grok Build ACP
架构概览 —— MCP / SSE / REST / SQLite schema
📚 研发流程 SOP —— 以 Issue 为中心的 AI-Native 研发迭代流程（方法论总览：Issue-Centric / Release Ops / Verify-First / Agent Dispatch / Retro 5 章节）
@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，欢迎聊。

Name		Name	Last commit message	Last commit date
Latest commit History 1,371 Commits
.github		.github
agent-network		agent-network
agent-node		agent-node
channel		channel
docs-site		docs-site
docs		docs
examples		examples
scripts		scripts
server		server
test-results		test-results
tests		tests
.env.example		.env.example
.gitattributes		.gitattributes
.gitignore		.gitignore
.mcp.json		.mcp.json
AGENTS.md		AGENTS.md
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
NOTICE		NOTICE
README.en.md		README.en.md
README.md		README.md
SECURITY.md		SECURITY.md

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Agent Network

30 秒上手（首次安装）

已装 anet？升级到最新

下一步

为什么用 Agent Network

anet vs 其他多 Agent 框架

Dashboard 预览

架构

四种 Runtime

Grok Build 接入

Provider 接入

套件包

仓库结构

状态 & 已知限制

贡献

安全

生态项目

Star History

资源

加入社群 / Join us

鸣谢

License

About

Uh oh!

Releases 15

Packages

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

Agent Network

30 秒上手（首次安装）

已装 anet？升级到最新

下一步

为什么用 Agent Network

anet vs 其他多 Agent 框架

Dashboard 预览

架构

四种 Runtime

Grok Build 接入

Provider 接入

套件包

仓库结构

状态 & 已知限制

贡献

安全

生态项目

Star History

资源

加入社群 / Join us

鸣谢

License

About

Topics

Resources

License

Code of conduct

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases 15

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages