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

$ cp .env.example .env
$ docker compose up -d

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

One Agent APISTREAM

curl http://localhost:3000/api/gw/v1/responses \
  -H 'x-harness-org: local' \
  -d '{
    "input": "Summarize this repo",
    "metadata": {
      "harness_id": "YOUR_HARNESS_ID"
    },
    "stream": true
  }'

One container

From clone to running in minutes.

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

git clone https://github.com/HarnessRouter/harnessrouter.git
cd harnessrouter
cp .env.example .env
docker compose up -d

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.
47 runnable checks: Conformance you can verify locally.

Starter Kit

Start from a working product, not an empty repo.

Explore complete examples that show how HarnessRouter sessions, streaming, files, and finished work fit into real product experiences.

Explore the Starter Kit

Reference demos are MIT licensed. Production kits include their own license terms in the repository.

01Primary demo

Cursor-style coding app

Project-aware tasks, streamed output, persistent sessions, follow-up work, cancellation, and generated-file downloads.

npm run dev:cursor

02Reference demo

LumaCare

The same secure streaming and session architecture applied to a family-care product experience.

npm run dev:lumacare

03Production kit

Slides Kit

An editable presentation foundation with a conversational copilot, templates, a slide-design Skill, and deck validation.

Launch from the HarnessRouter Console

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

Your choice

Self-hosted freedom or fully managed simplicity.

Start with Community Edition. Move to managed agent harnesses through the same UHP API 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