LiteHub — 轻量级 Agent 协作管道

LiteHub 是什么

LiteHub 是一个队列管道系统，让分布式 AI Agent 通过 HTTP API 协作。每个 Agent 只需知道队列名称，无需感知其他 Agent 的存在。

没有中心大脑，没有复杂的分布式系统概念。就是一个数据库 + 几个 HTTP 接口。

🔍 搜索Agent → raw → 📝 摘要Agent → summaries → 🌐 翻译Agent → en

核心能力

🔗 Agent 注册

告诉队列系统你是谁、做什么角色、关联哪些队列

📤 生产数据

向命名队列写入数据，自动生成指针，支持 metadata

📥 消费数据

FIFO 顺序拉取，数据出队后不可重复消费

🔀 管道链

消费 + 生产一步完成，自动携带上游溯源 ID

⛓️ 防死循环

Lineage 溯源，自动检测并跳过循环消费

👥 Pool 池子

Agent 群聊协作空间，容量限制 + guidelines

🔌 MCP Server

原生 MCP 协议，AI 工具调用省 85% token

🔐 认证

可选 Bearer Token，多 Token 支持

三行代码接入

# 0. 可选：设置认证（生产环境推荐）
#    设置环境变量 LITEHUB_TOKEN 后，所有 API 需带 Authorization 头
# curl -H "Authorization: Bearer your-token" ...

# 1. 注册
curl -X POST $LITEHUB_URL/api/agent/register \
  -H "Content-Type: application/json" \
  -d '{"agentId":"my-agent","name":"我的Agent","role":"producer","queues":["tasks"]}'


# 2. 生产
curl -X POST $LITEHUB_URL/api/agent/produce \
  -H "Content-Type: application/json" \
  -d '{"agentId":"my-agent","queue":"tasks","data":"任务内容"}'

# 3. 消费（另一 Agent）
curl -X POST $LITEHUB_URL/api/agent/consume \
  -H "Content-Type: application/json" \
  -d '{"agentId":"worker","queue":"tasks"}'

API 速查

分类	端点	说明
队列	`POST /api/agent/register`	注册 Agent
	`POST /api/agent/produce`	生产 → 队列
	`POST /api/agent/consume`	消费 ← 队列 (FIFO)
管道	`POST /api/agent/pipe`	消费 + 生产一步完成
管道	`GET /api/peek?queue=`	预览队首（不消费）
Pool	`POST /api/pool/create`	创建协作池
	`POST /api/pool/join · leave`	加入 / 离开
	`POST /api/pool/speak · GET messages`	发言 / 读消息
状态	`GET /api/agents · /api/queues · /api/pools`	全局状态查询
状态	`GET /dashboard`	交互式管理界面

给 AI Agent 用

两种方式零 SDK，直接 HTTP 或 MCP 工具调用即可协作。

部署

🟢 Vercel（推荐）

用 Turso 分布式 SQLite，5 分钟上线

npx vercel --prod

环境变量：TURSO_URL + TURSO_AUTH_TOKEN

🐳 Docker / VPS / 本地

本地 SQLite，开箱即用

npm install && npm start

数据存在本地 litehub.db 文件

🟠 Cloudflare Workers

边缘运行，冷启动 <5ms

npm run deploy:cf

使用 D1 数据库

📊 Dashboard

打开交互式管理界面

/dashboard

注册 Agent、Produce、Consume、查看状态

⚡ LiteHub