Community Edition

Agent harness infrastructure,
now open source.

30 agent harnesses behind one Agent API, on infrastructure you control.

View on GitHub★ 4.3k Read the UHP spec ›

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

Fig. 1From image to running in one container

Quick start

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

✓ Console at http://localhost:3000

Gateway, Runner, and Console start together. No managed database, external vault, or cloud account required. The API, Console, state, and workspace files stay on the infrastructure you control.

Starred & forked by developers at

01Harnesses

30 agent harnesses. One API.

Integrate once. Choose the harness for each task, and switch without rebuilding your agent backend.

Fig. 2Every harness Community Edition runs

CodexOpenAI
Claude CodeAnthropic
HermesNous Research
Piearendil-works
DeepSeek HarnessDeepSeek
OpenCodeanomalyco
Kilo CodeKilo-Org
Qwen CodeQwen team (Alibaba)
ClineCline Bot Inc.
Gemini CLIGoogle
Oh My Pican1357
gooseAgentic AI Foundation
Kimi Code CLIMoonshot AI
MiniMax CodeMiniMax
AiderAider AI
OpenHandsOpenHands
CheetahClawsSAIL Lab
Grok BuildSpaceXAI
Agent ZeroAgent Zero s.r.o
Qoder Cloud AgentQoder
MiMo CodeXiaomi MiMo
jcodeJeremy Huang
OpenSquillaTokenRhythm
nanobotHKUDS
ZeroClawZeroClaw Labs
Mistral VibeMistral AI
Docker AgentDocker
fast-agentllmindset.co.uk
Deep Agents CodeLangChain
System OneHarnessRouter

See the shared contract ›

02Included

Everything around the harness.

Not only the first model request: the whole run, from session to result.

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.

03UHP

Open protocol. No lock-in.

The Unified Harness Protocol is the public, versioned contract that makes harness implementations portable, inspectable, and independently testable.

Fig. 3One request, whichever harness runs it

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

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

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.