overseer-client 0.1.0

Overseer 客户端：其他 AI agent 安装此包连接 overseer 服务器，上报工具、领取任务、参与多AI协同

overseer-client

Overseer 多 AI 协同平台的客户端库。

其他 AI agent 安装此包后可连接 overseer 服务器：

• 注册为 worker（首个连接者自动成为 overseer）
• 上报本地 MCP 工具与资源
• 主动领取任务并执行
• 接收 overseer 审查反馈
• 通过 SSE 订阅事件流

安装

pip install overseer-client

# 如需启用本地工具回调服务（供服务器反向调用本 agent 工具）：
pip install "overseer-client[callback]"

快速开始

import asyncio
from overseer_client import OverseerClient, ClientConfig

async def main():
    cfg = ClientConfig(
        server_url="http://127.0.0.1:8787",
        agent_name="my-worker",
        # token="your-token",  # 服务器启用鉴权时填写
    )
    async with OverseerClient(cfg) as client:
        print(f"connected: {client.agent_id} as {client.role}")
        # client 会自动心跳、轮询领取任务、订阅事件
        await asyncio.sleep(60)

asyncio.run(main())

配置

支持配置文件（~/.overseer/client.json）和环境变量：

环境变量	说明
OVERSEER_SERVER_URL	服务器地址，默认 http://127.0.0.1:8787
OVERSEER_AGENT_NAME	agent 名称
OVERSEER_TOKEN	鉴权 token（服务器启用时必填）
OVERSEER_CALLBACK_PORT	本地回调端口，0 表示不启用

License

MIT