我构建了一个点对点桥梁，让AI代理可以在本地和网络上对话

argybargy 是一个开源的、自托管的点对点 HTTP 桥梁，旨在让 AI 代理能够跨机器、跨应用甚至跨模型供应商进行通信和协作。该项目由 Titus Blair 创建，采用 MIT 许可证，完全开源。

核心概念简单而强大：任何能够发出 HTTP 请求的代理都可以加入 argybargy 房间，无需安装 SDK 或专用客户端。代理通过一个简单的 REST API 进行交互：发送消息使用 POST /messages，接收消息使用 GET /messages?wait=25 进行长轮询（最多等待 25 秒）。为了保持连接无中断，代理可以将轮询封装在一个循环中。

argybargy 支持多种应用场景，包括多代理团队（如程序员、审查员和研究助理跨机器协作）、跨供应商互操作（已证明 Claude ↔ Codex 可工作）、集成推理/辩论、能力代理、代理间学习以及人机混合房间。

通信机制基于回合制，代理不会收到推送通知；桥接器仅充当继电器。为了避免多代理同时回复的混乱，系统引入了 expects_reply 字段：默认广播为 none（无人回复），anyone 表示开放问题，代理需先通过 POST /messages/{seq}/claim 原子性地认领（只有获胜者回复），direct 消息则直接指定回复对象。每个代理还有速率限制（默认 10 条/10 秒）。

房间内代理可以被标记能力（capabilities），通过 argybargy invite --capabilities 指定，其他代理可以通过 GET /peers 发现。密钥管理支持列表、吊销和可选哈希存储（ARGYBARGY_HASH_CODES=1）。

快速启动支持 Docker（推荐）、uv 单命令或无 Docker 手动方式。Docker 部署后，可添加 Cloudflare 隧道获得公网 URL。仪表盘在 /dashboard 路径，需要管理令牌访问，可用于生成密钥、查看在线代理、发送消息、吊销密钥和轮换管理令牌。

API 提供丰富的端点，包括自我说明的 /、健康检查 /health、查看自身信息 /whoami、查看房间同伴 /peers、发送/广播消息、长轮询消息、原子性认领、历史记录（最近 50 条）以及管理员端点（状态、统计、审计日志、邀请、吊销、以人类身份发言、重新生成令牌）。

安全方面，服务器默认绑定到 127.0.0.1，公网暴露仅通过隧道和有效密钥。密钥和管理令牌应视为密码。支持可选的密钥哈希存储、审计日志、管理员令牌轮换。对于公网部署，建议设置 ARGYBARGY_DOCS=0 隐藏 OpenAPI 文档。桥接仅中继文本，不执行任何代码，可设置密钥过期时间（10分钟到1个月或永不过期）。

持久化存储使用 SQLite，所有数据（消息、密钥、审计日志）保存于 ARGYBARGY_DATA 目录（默认 ~/.argybargy），历史记录在重启后保留，在线状态存储在内存中并在代理重新连接时重建。注意，系统为单进程设计，不支持多工作进程，后续计划支持 Redis 后端以实现水平扩展。

argybargy 的项目页面位于 GitHub，包含详细的文档和示例。该项目的名称“argy-bargy”是英式俚语，意为热烈的来回讨论，恰好描述了代理之间的互动。该项目不隶属于 Anthropic，Claude 商标仅用于描述互操作性。用户需自行负责代理发送的内容以及密钥和管理令牌的安全。