harnessrouter
HarnessRouter Community Edition:自行託管的 Apache-2.0 版本,為代理工具提供統一介面。可執行 Codex、Claude Code、Hermes、PI、DSH 等。
harnessrouter 是什麼?
HarnessRouter Community Edition:自行託管的 Apache-2.0 版本,為代理工具提供統一介面。透過單一 API 執行 Codex、Claude Code、Hermes、PI、DSH 等工具,支援工作階段、串流、檔案、取消及錯誤處理。實作開放標準 Unified Harness Protocol (UHP)。使用您自己的金鑰與基礎架構。
harnessrouter 概覽
這是什麼
HarnessRouter Community Edition 是統一代理工具(agent harness)介面的自託管、Apache-2.0 版本。它實作了 Unified Harness Protocol (UHP),並提供與 OpenAI Responses 相容的 API。它將現有的工具(如 Codex 和 Claude Code)轉換為可插拔的代理後端,處理持久化工作階段、串流進度、檔案、成品、取消任務和結構化錯誤。
主要功能
- 統一的 API 支援多種代理工具(Codex、Claude Code、Hermes、PI、DSH 等)
- 實作 Unified Harness Protocol (UHP) 開放標準
- 與 OpenAI Responses 相容的 API,便於整合
- 持久化工作階段,支援串流進度、檔案附件和成品擷取
- 任務取消與結構化錯誤處理
- 自託管,使用自己的提供者金鑰和基礎設施
- 可在不同工具與模型配置間切換,以最佳化成本與延遲
使用情境
建構代理產品,無需處理工具工程。將 HarnessRouter 作為基礎設施層,透過單一 API 執行任務、取得結果並切換工具。適合將代理後端整合到產品後端、使用自訂或內建工具執行自動化任務,以及透過單一介面管理多個模型提供者。
快速開始
使用自己的提供者金鑰自託管 Community Edition。需要 Docker、約 4 GB 磁碟空間和一個提供者 API 金鑰。無需 HarnessRouter 帳戶。1. 啟動 HarnessRouter:docker run -d --name harnessrouter -p 127.0.0.1:3000:3000 -v harnessrouter:/data harnessrouter/harnessrouter2. 等待首次啟動(檢查日誌直到顯示 ready on :3000)。3. 開啟 http://localhost:3000,使用使用者名稱 harnessrouter、密碼 harnessrouter 登入(請在個人資料中變更預設密碼)。4. 透過側邊欄的「Bring Your Own Key」連接模型提供者。5. 在「Agent harnesses」中執行第一個任務。如需自訂工具,請在控制台中建立並設定。如需 API 整合,請建立 API 金鑰並呼叫與 OpenAI Responses 相容的端點。
授權與價格
採用 Apache-2.0 授權。開放原始碼、自託管的 Community Edition。不包含捆綁模型或試用金鑰。自託管無需 HarnessRouter 帳戶。
內容整理自該專案公開的 README 與儲存庫資訊。