HarnessRouter Community Edition

Agent harness infrastructure, now open source.

Plug 10 agent harnesses, Codex and Claude Code to Gemini CLI and Oh My Pi, into your product through one Agent API, on your own infrastructure.

View on GitHub Read the UHP spec

Apache 2.0 One Docker container Your keys, state, and files

HarnessRouter Community Edition Console showing locally managed agent harnesses

Quick startLOCAL

$ docker pull harnessrouter/harnessrouter
$ docker run -d --name harnessrouter \
  -p 127.0.0.1:3000:3000 \
  -e HR_AUTH_PASSWORD='change-me' \
  harnessrouter/harnessrouter

✓ HarnessRouter is running
  Console  http://localhost:3000

One Agent APISTREAM

curl -c hr.cookies localhost:3000/api/selfhost/login \
  -H 'content-type: application/json' \
  -d '{"username":"harnessrouter","password":"YOUR_PASSWORD"}'

curl -b hr.cookies localhost:3000/api/harness/v1/responses \
  -H 'content-type: application/json' \
  -d '{
    "input": "Summarize this repo",
    "metadata": {
      "harness_id": "YOUR_HARNESS_ID"
    },
    "stream": true
  }'

One container

From image to running in minutes.

Gateway, Runner, and Console start together. No managed database, external vault, or cloud account required.

docker pull harnessrouter/harnessrouter
docker run -d --name harnessrouter -p 127.0.0.1:3000:3000 -v harnessrouter:/data -e HR_AUTH_PASSWORD='change-me' harnessrouter/harnessrouter
docker logs -f harnessrouter

The API, Console, SQLite state, and workspace files stay on the infrastructure you control.

One API for leading harnesses

10 agent harnesses. One API.

Integrate once, select the harness for each task, and switch without rebuilding your product backend.

See the shared contract

Codexby OpenAI

Claude Codeby Anthropic

Hermesby Nous Research

Piby earendil-works

DeepSeek Harnessby DeepSeek

OpenCodeby anomalyco

Qwen Codeby Qwen team (Alibaba)

Clineby Cline Bot Inc.

Gemini CLIby Google

Oh My Piby can1357

Complete lifecycle

Everything you need to run agents in production.

HarnessRouter handles the backend lifecycle around each harness, not only the initial model request.

Sessions: Create, resume, and inspect agent sessions.
Streaming: Follow tokens and events while work runs.
Files: Upload inputs and persist workspace files.
Artifacts: Return finished outputs for your product.
Cancellation: Stop running work through one contract.
Failure handling: Handle structured errors consistently.

Unified Harness Protocol (UHP)

Open protocol. No lock-in.

UHP is the public, versioned contract that makes harness implementations portable, inspectable, and independently testable.

Read the UHP spec

Versioned spec: A stable, reviewable HTTP contract.
OpenAI Responses API compatible: Existing SDKs, streaming parsers, and UI code work unchanged.
OpenAPI 3.1: Machine-readable API definitions.
JSON Schema 2020-12: Strong contracts for every object.
64 runnable checks: Conformance you can verify locally.
Apache 2.0 reference server: Community Edition implements the full protocol.

Starter Kit

Start from a working product, not an empty repo.

Four whole products, launched from the console and running on your own instance. Each kit ships an app, a configured agent, and the skill that teaches it what to build.

Explore the Starter Kit

Kits are licensed under the HarnessRouter Starter Kit License; the repository states the full terms.