HarnessRouter Community Edition

Agent harness infrastructure, now open source.

Plug Codex, Claude Code, and Hermes into your product through one Agent API, on your own infrastructure.

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

Codex. Claude Code. Hermes. 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

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.
OpenAPI 3.1: Machine-readable API definitions.
JSON Schema 2020-12: Strong contracts for every object.
52 runnable checks: Conformance you can verify locally.

Starter Kit

Start from a working product, not an empty repo.

Four whole products, each launched from the console and running on your own instance. Use one, then read it: every kit is open source, and it is the shortest road from seeing how one works to building the one your customers need.

Explore the Starter Kit

Production kits include their own license terms in the repository. The reference demos alongside them are MIT licensed.

01Production kit

Slides

Ask for a presentation and the agent works the way a designer does: structure first, then a style system, then slide by slide. Everything it makes is an object on the canvas you can drag, retype and restyle.

Launch from the HarnessRouter Console

Slides Kit interface showing the presentation prompt and editable template library — The Slides kit, with its prompt-driven workflow and built-in presentation templates.

02Production kit

Sheets

Rows are your data. An agent column runs one of your other agents once per row, builds its input from the columns to its left, and fills each cell with what that agent said and made.

Launch from the HarnessRouter Console

03Production kit

Dashboards

Say what you want to understand. The agent reads your schema, writes the SQL, picks the charts that answer it and lays them out. Opening it re-runs every query, through a SELECT-only account.

Launch from the HarnessRouter Console

04Production kit

Videos

The agent plans the shots, renders them, and lays them on a canvas as they land. Cut them on a real timeline, add a music bed and a voice-over, and export one file.

Launch from the HarnessRouter Console

Your choice

Self-hosted freedom or fully managed simplicity.

Start with Community Edition. Move to managed agent harnesses when your product needs cloud scale.

Community Edition

Open source

Run the full agent backend on infrastructure you control.

Gateway, Runner, and Console in one container
Your provider keys, state, and files
Local SQLite and workspace volume
Apache 2.0

View on GitHub

HarnessRouter Cloud

Fully managed

Use the same API without operating agent infrastructure.

Serverless sandboxed execution
Managed concurrency and isolation
Execution tracing
Harness × Model comparison for each task

Explore Cloud