HarnessRouter

项目简介

HarnessRouter 是产品与受支持智能体运行框架之间的执行和运行时层。LLM 只返回 token，而运行框架为它提供沙箱、工具和循环，使其真正完成工作；HarnessRouter 将 Codex、Claude Code 等现有运行框架变成即插即用的智能体后端。应用通过一个接口发送任务，并接收进度、文件、产物、最终状态和追踪信息，该接口以统一运行框架协议（UHP）实现，并提供兼容 OpenAI Responses 的 API。它既有自托管的 Apache 2.0 社区版，也有托管的 HarnessRouter Cloud。

核心功能

• 所有受支持智能体运行框架共用一套 API 契约，因此产品在新增运行框架时仍只需维护一个集成。实现统一运行框架协议（UHP）这一开放标准，并暴露兼容 OpenAI Responses 的 API。处理智能体执行生命周期：会话、工具、文件、产物、流式进度、取消、错误、恢复和追踪。社区版采用 Apache 2.0，运行在你自己控制的基础设施上，使用你自己的密钥、状态和文件。Cloud 为每个任务预置并运行一个隔离沙箱，无需基础设施运维即可扩展工作负载。运行框架 × 模型路由让团队在切换生产流量前按质量、延迟和成本对组合进行基准测试。

适用场景

• 在 Codex、Claude Code、Hermes 或其他受支持运行框架之上构建新的智能体产品。将现有托管智能体后端迁移到 HarnessRouter。在 Harness Arena 中跨运行框架运行同一任务，比较时间、成本和准确性。从 Slides、Sheets、Dashboards、Videos 等开源入门套件开始。

快速开始

• 运行容器：docker run -d --name harnessrouter -p 127.0.0.1:3000:3000 -v harnessrouter:/data harnessrouter/harnessrouter。通过跟踪 docker logs 等待首次启动，直到日志显示 [harnessrouter] ready on :3000。打开 http://localhost:3000，使用用户名 harnessrouter 和密码 harnessrouter 登录。在 Bring Your Own Key 下连接模型提供商并添加其 API

部署与要求

• 需要 Docker、约 4 GB 磁盘和提供商 API 密钥；社区版不需要 HarnessRouter 账户或捆绑试用密钥。不要添加 --user：入口点和 Runner 需要 root 来管理每会话用户，而 Console 和 Gateway 以非特权运行，智能体进程以其会话用户身份运行。使用初始凭据时保持回环绑定。使用 harnessrouter:/data 这样的命名卷，在重启之间保留数据库、文件、已安装的运行框架 CLI 和工作区。

采用前须知

• 许可证：Apache-2.0。在使用、修改或分发项目前，请确认其具体条款。