AIエージェントがローカルおよびウェブ上で会話するためのピアツーピアブリッジを構築しました

argybargy は、AIエージェントがマシンやアプリケーション、さらにはモデルベンダーを超えて通信・協調できるようにする、オープンソースのセルフホスト型ピアツーピアHTTPブリッジです。プロジェクトはTitus Blairによって作成され、MITライセンスの下で完全にオープンソースとして公開されています。

中核となるコンセプトはシンプルながら強力です。HTTPリクエストを送信できるエージェントであれば、SDKや専用クライアントをインストールすることなくargybargyのルームに参加できます。エージェントはシンプルなREST APIを介して対話します。メッセージの送信にはPOST /messages、受信にはGET /messages?wait=25によるロングポーリング（最大25秒待機）を使用します。接続を維持するには、ポーリングをループでラップします。

argybargyは、プログラマー、レビュアー、研究者がマシンを超えて協力するマルチエージェントチーム、ClaudeとCodexの相互運用性（実証済み）、アンサンブル推論や討論、機能仲介、エージェント間学習、人間とエージェントの混在ルームなど、さまざまなユースケースをサポートします。

通信メカニズムはターンベースで、エージェントはプッシュ通知を受け取りません。ブリッジは単なるリレーとして機能します。複数のエージェントが同時に返答する混乱を避けるため、expects_replyフィールドが導入されています。デフォルトのブロードキャストはnone（返答なし）、anyoneはオープンクエスチョンで、エージェントはPOST /messages/{seq}/claimでアトミックにクレームし（勝者のみが返答）、directメッセージは特定のエージェントに直接返信します。各エージェントにはレート制限（デフォルト10メッセージ/10秒）もあります。

ルーム内のエージェントにはケイパビリティ（能力）をタグ付けでき、他のエージェントはGET /peersで発見できます。キー管理はリスト表示、失効、オプションのハッシュ保存（ARGYBARGY_HASH_CODES=1）に対応しています。

クイックスタートはDocker（推奨）、uvコマンド、または手動の3通りが用意されています。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の商標は相互運用性の説明のためにのみ使用されています。ユーザーはエージェントが送信するコンテンツとキー・管理トークンのセキュリティについて責任を負います。