convez.ai
MCP ServerAutomaçãoIntermediário
sleep2agi

Agent Network

sleep2agi/agent-network

Orquestre múltiplos agentes e LLMs em uma rede mesh local

Ver no GitHub
BomPluginScore · de 0 a 100

Rede de colaboração multi-agente que orquestra 4 runtimes e 8 provedores de LLM (Anthropic, OpenAI, xAI, DeepSeek, etc.) em uma malha local-first. Agentes se comunicam via MCP, compartilham contexto e delegam tarefas entre si — instalável como um único pacote npm com dashboard web integrado.

Instalação

$npx convez-ai sleep2agi/agent-network

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
121
Forks
15
Acompanhando
1
Saúde
87%
Último commit
há 1 dia
Versão
v2.2.15
Issues abertas
238
Contribuidores
3

Casos de uso

  • Coordenar múltiplos agentes para dividir tarefas complexas
  • Executar workflows multi-LLM sem dependência de cloud
  • Prototipar sistemas de agentes distribuídos com dashboard visual
  • Integrar Claude, GPT, Grok e modelos open-source em um único fluxo

Veredito

Ferramenta robusta para orquestração multi-agente em ambiente local. Ideal para quem quer prototipar sistemas complexos sem vendor lock-in, mas requer familiaridade com Node.js e conceitos de arquitetura distribuída. Documentação em chinês é um ponto de atrito para não-falantes.

README

A tradução para o português deste README ainda está na fila.


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 秒上手之后:


为什么用 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 框架

维度anetLangGraphAutoGenCrewAI
部署模式本地优先 + 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 中枢,自动发现编程式 graphgroup chathierarchy / sequential
人 + Agent 同台✅ Dashboard Chat 同界面n/a(纯程序)n/an/a
部署形态一个 npm 包pip + 自写 serverpip + 自写 serverpip + 自写 server

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


Dashboard 预览

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


架构

┌──────────┐   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-clispawn 本地 claude CLI 子进程复用 Claude Pro 订阅,享 Claude Code 全套工具本地 claude 已登录
claude-agent-sdk编程式调 Anthropic 兼容 APIAnthropic / MiniMax / DeepSeek / GLM / Kimi / 书生 / 小米 MiMo / OpenRouter 等(通过 ANTHROPIC_BASE_URL)API key
codex-sdkOpenAI @openai/codex-sdk写代码 / 跑命令codex auth login 或 OPENAI_API_KEY
grok-build-acp本地 grok agent stdio + Agent Client ProtocolGrok 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 · verifiedhttps://api.anthropic.com
MiniMax内置 vendor · verifiedhttps://api.minimaxi.com/anthropic
小米 MiMo内置 vendor · verifiedhttps://token-plan-cn.xiaomimimo.com/anthropic
书生 Intern内置 vendor · verifiedhttps://chat.intern-ai.org.cn(裸域名,无 /anthropic)
OpenAI Codex(codex-sdk)内置 vendor · verifiedn/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-network2.2.10anet 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-server0.8.4MCP + 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-dashboard0.5.6Web Dashboard —— Next.js 16,图片上传/粘贴发送(v0.10.9)+ 4 套主题 + Hero 3 网络节点前端 8/8 surface + Servers 面板 polish + 100+ 轮 typography & 圆角级联 polish
@sleep2agi/agent-node2.4.7Agent 运行时 —— 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] 公网自部署有风险,先看完这一段再开放安全组。 当前默认配置只为本机使用优化:

  1. 默认账号 admin / anethub —— 任何公网部署都必须立刻 anet passwd 改密,否则被人扫到端口就能进
  2. Hub 默认绑 127.0.0.1 —— 公网模式(--host 0.0.0.0)必须配反代(Caddy / Nginx)+ TLS,不要把 9200 / 3000 直接挂公网
  3. 多租户隔离依赖 network scope —— v0.8 起已强制用户 / 节点按 network 访问;仍不要把互不信任的人放进同一个 network
  4. 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


资源


加入社群 / 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

Ver o original no GitHub

Bom para

Relacionados