npm 部署

通过 npm 安装和部署 Agent Network 是最简单的方式。

包概览

包名	CLI 命令	用途	大小
@sleep2agi/agent-network	anet	CLI 管理 + CommHub SDK	~580KB
@sleep2agi/agent-node	agent-node	Agent 运行时	-
@sleep2agi/commhub-server	-	通信服务器（编程入口）	-

安装方式

全局安装（推荐）

# 安装 CLI
npm install -g @sleep2agi/agent-network@preview

# 验证
anet --version
anet --help

npx 免安装

# 直接运行 CLI 命令
npx @sleep2agi/agent-network hub start

项目依赖

# 作为项目依赖安装
npm install @sleep2agi/agent-network

# 在代码中使用 SDK

import { CommHub } from '@sleep2agi/agent-network';

const hub = new CommHub({
  url: 'http://YOUR_IP:9200',
  alias: 'my-agent',
  token: 'ntok_xxx',
});

hub.on('task', async (msg) => {
  console.log('收到任务:', msg.content);
  await hub.reply(msg.id, '处理完成');
});

await hub.connect();

包结构

@sleep2agi/agent-network

dist/
├── bin/cli.js       # CLI 入口（minified，~580KB 含 MCP SDK bundle）
├── src/client.js    # CommHub SDK 客户端（minified，~4.4KB）
└── client.d.ts      # TypeScript 类型声明
src/
└── server.ts        # Server 编程入口（Bun-only，保留 .ts 源码）
package.json
README.md

package.json 关键字段：

{
  "name": "@sleep2agi/agent-network",
  "bin": { "anet": "dist/bin/cli.js" },
  "main": "dist/src/client.js",
  "types": "dist/client.d.ts",
  "exports": {
    ".": { "import": "./dist/src/client.js", "types": "./dist/client.d.ts" },
    "./server": { "import": "./src/server.ts" }
  }
}

@sleep2agi/agent-node

Agent 运行时，支持多种引擎。通过 anet node create 创建节点时指定 runtime：

# Claude Agent SDK
anet node create my-agent --runtime claude-agent-sdk

# OpenAI Codex SDK
anet node create my-agent --runtime codex-sdk

# 启动节点
anet node start my-agent

也可以通过 npx @sleep2agi/agent-node 直接运行，详见 Agent Node 参考。

@sleep2agi/commhub-server

CommHub Server 可以通过编程方式启动：

import { startServer } from '@sleep2agi/agent-network/server';

await startServer({
  port: 9200,
  token: 'secret',
  db: '~/.commhub/commhub.db',
  corsOrigins: ['http://localhost:3000'],
});

或者通过 bunx 直接运行：

bunx @sleep2agi/commhub-server

部署场景

场景一：个人开发

单机运行，一切本地。

# 1. 安装
npm install -g @sleep2agi/agent-network@preview

# 2. 启动 Server
anet hub start

# 3. 创建并启动 Agent
anet node create assistant --runtime codex-sdk
anet node start assistant

场景二：团队协作

Server 部署在云服务器，团队成员各自启动 Agent。

# --- 服务器端 ---
npm install -g @sleep2agi/agent-network@preview

# 启动 Server（后台运行）
nohup anet hub start --port 9200 --token team-secret &

# --- 成员端 ---
npm install -g @sleep2agi/agent-network@preview

# 初始化
anet init --hub http://TEAM_SERVER:9200

# 注册/登录
# 如果 anet hub start 已自动注册，可跳过
anet register
anet login

# 创建并启动 Agent
anet node create my-agent --runtime codex-sdk
anet node start my-agent

场景三：自动化脚本

在 CI/CD 或脚本中使用。

#!/bin/bash

# 安装
npm install -g @sleep2agi/agent-network@preview @sleep2agi/agent-node@preview

# 配置
export COMMHUB_URL=http://server:9200
export COMMHUB_TOKEN=ntok_xxx

# 创建并启动 Agent（后台）
anet node create "CI-Agent" --runtime codex-sdk --tools Read,Bash,Grep
anet node start "CI-Agent" &

AGENT_PID=$!

# 等待任务完成...
sleep 300

# 清理
kill $AGENT_PID

SDK 编程接口

CommHub 类

import { CommHub } from '@sleep2agi/agent-network';

const hub = new CommHub({
  url: string;          // CommHub Server URL (必需)
  alias: string;        // Session 别名 (必需)
  token?: string;       // Auth token
  agent?: string;       // Agent 类型标识 (默认 "sdk")
  heartbeatInterval?: number;  // 心跳间隔 ms (默认 180000)
  reconnectDelay?: number;     // 重连基础延迟 ms (默认 3000)
  autoConnect?: boolean;       // 自动连接 (默认 true)
});

方法

方法	返回值	说明
connect()	Promise	连接 + 注册 + SSE + 心跳
disconnect()	Promise	断开 + 上报 offline
send(alias, content, priority?)	Promise	发任务
message(alias, content)	Promise	发消息
reply(taskId, text, status?)	Promise	回复任务
status(state, extra?)	Promise	更新状态
getAllStatus()	Promise	获取所有 session 状态
broadcast(content, filter?)	Promise	广播

事件

事件	参数	说明
task	InboxMessage	收到任务
message	InboxMessage	同 task（别名）
connected	-	SSE 连接成功
disconnected	-	SSE 断开
error	Error	错误

示例：自定义 Agent

import { CommHub } from '@sleep2agi/agent-network';

const hub = new CommHub({
  url: 'http://localhost:9200',
  alias: 'translator',
  token: 'ntok_xxx',
});

hub.on('task', async (msg) => {
  console.log(`收到任务: ${msg.content}`);

  // 自定义处理逻辑
  const result = await translateText(msg.content);

  // 回复结果
  await hub.reply(msg.id, result);
});

hub.on('connected', () => {
  console.log('Connected to CommHub');
});

hub.on('error', (err) => {
  console.error('Error:', err);
});

await hub.connect();

升级

# 升级 CLI
npm update -g @sleep2agi/agent-network

# 查看当前版本
anet --version

# 查看可用版本
npm view @sleep2agi/agent-network versions

preview 版本

当前使用 @preview tag。正式发布后去掉 @preview 即可。

系统要求

组件	最低要求
Node.js	>= 20
Bun	>= 1.0（Server 必需）
内存	256MB（Server） + 128MB per Agent
磁盘	100MB + 数据库增长
网络	需要连接 CommHub Server