LibreAI / Développement / harnessrouter
// devtools · HarnessRouter/harnessrouter

harnessrouter

harnessrouter est un projet de développement open source, créé par HarnessRouter (HarnessRouter/harnessrouter sur GitHub). Il compte 2 929 étoiles sur GitHub et 299 forks, il est publié sous la licence Apache-2.0 et a été mis à jour pour la dernière fois sur GitHub le 8 octobre 2026.

One API for every agent harness — run Codex, Claude Code and more through a single self-hosted interface

★ 2,9 k étoiles⑂ 299 forksApache-2.0mis à jour oct. 2026
▦ visuel — le README de ce projet ne contient aucune capture intégrable,
voici donc un emplacement réservé. Le guide ci-dessous est complet malgré tout.
// détails du projet

Détails du projet

Étoiles GitHub
2 929
Forks
299
Licence
Apache-2.0
Dernière mise à jour sur GitHub
8 octobre 2026
Catégorie
Développement
Type de fiche
Guide d'installation complet
Site officiel
Official site
// fonctionnement

Comment ça marche

  1. Clarify your goal

    Decide which harnesses you want behind one API and which model providers you will connect with your own keys.

  2. Get HarnessRouter

    Pull and run the official Docker image with a persistent data volume.

  3. Install and configure

    Wait for first launch to install the enabled harness CLIs, sign in to the console, and add a model provider under Bring Your Own Key.

  4. Run your first task

    Submit a task through the console or the OpenAI Responses-compatible API and watch it stream, then try switching harnesses.

// fonctionnalités

Pourquoi on l'adore

Unified Harness Protocol

Implements UHP, an open standard, so harnesses become plug-and-play agent backends behind one integration.

Many harnesses, one API

Run Codex, Claude Code, Hermes, PI, DSH and more, and switch harnesses per task to optimize cost and latency.

OpenAI Responses-compatible

Provides an OpenAI Responses-compatible API for product integration.

Sessions and streaming

Persistent sessions, streaming progress, files and artifacts are handled by the router.

Cancellation and failures

Built-in cancellation and structured failure handling across harnesses.

Self-hosted, your keys

Community Edition runs on your infrastructure with your own provider keys; data persists in a Docker volume.

Advertisement
// lancez-le

Lancez-le vous-même

  1. Clone the repo

    Clone HarnessRouter (the quickest run path is the Docker image in step 2).

    git clone https://github.com/HarnessRouter/harnessrouter.git
    cd harnessrouter
  2. Run with Docker

    Start the self-hosted Community Edition exactly as the README quickstart shows.

    docker run -d --name harnessrouter \
      -p 127.0.0.1:3000:3000 \
      -v harnessrouter:/data \
      harnessrouter/harnessrouter
  3. Open the console

    Wait for '[harnessrouter] ready on :3000' in the logs, then open http://localhost:3000 and sign in (default harnessrouter / harnessrouter).

    docker logs -f harnessrouter
// cas d'usage

Ce que vous pouvez créer

Readers working through the Dev Tools shelf also stop at Assistant, AI stack centered on an agent hypervisor. The Dev Tools shelf also holds openmed — Local-first healthcare AI: clinical NER and HIPAA PII de-identification that runs 100% on-device. Readers working through the Dev Tools shelf also stop at KiroCrew, a persistent, self-improving workspace where AI dev crews keep working after you close the tab.

Advertisement
// faq

Questions fréquentes

Who maintains HarnessRouter?

HarnessRouter (the team behind harnessrouter.ai) maintains it; this repo is the open Community Edition of their unified harness interface.

Is it free?

The Community Edition is free and Apache-2.0 licensed, self-hosted on your infrastructure. Harness CLIs installed on first launch keep their own upstream licenses.

Does it need a paid API key?

Yes — you bring your own model provider keys (added in the console under Bring Your Own Key); model usage is billed by your provider. You do not need a HarnessRouter API key to run console tasks.

How does it compare to integrating each harness directly?

Direct integration means handling sessions, streaming, files and failures separately for every harness. HarnessRouter gives one API and lets you switch harnesses freely.

How do I get started?

Run the Docker command from the README, wait for the ready log line, open http://localhost:3000, add a provider key, and run a task.

// continuez l'exploration

Outils similaires

Développement

mission-control

Self-hosted control plane for AI agents: dispatch tasks, review runs, track spend, and operate OpenClaw, Claude Code, Codex, and other runtimes.

★ 6,3 k étoilesMIT
Voir le guide →
Développement

git-iris

Self-hosted dev tools: an intelligent agent that understands your code and cra.

★ 41 étoilesApache-2.0
Voir le guide →
Développement

avibe

A local-first Agent OS — drive Claude Code, Codex and OpenCode from your browser.

★ 606 étoilesMIT
Voir le guide →
Développement

vibe-kanban

A kanban board for coding agents — plan tasks, run Claude Code or Codex in parallel, review diffs

★ 28,3 k étoilesApache-2.0
Voir le guide →
Développement

kicad-happy

AI coding agent skills for KiCad electronics design. Works with Claude Code and OpenAI Codex. Analyze schematics, review PCB layouts, EMC pre-compliance, SPI…

★ 1,3 k étoilesMIT
Voir le guide →
Développement

cc-switch

Cross-platform desktop all-in-one manager for Claude Code, Codex, OpenCode and other coding agents

★ 141,3 k étoilesMIT
Voir le guide →
// alternatives

Alternatives en Développement

Les autres projets de la catégorie Développement avec le plus d'étoiles du catalogue LibreAI — la sélection réaliste d'alternatives si harnessrouter ne vous convient pas.

// plus en devtools

Plus en Développement

Projets de la catégorie Développement proches dans le catalogue, les plus proches en étoiles de harnessrouter — continuez à explorer de part et d'autre.

Obtenir harnessrouter

Gratuit et ouvert : récupérez le code source, mettez une étoile au dépôt et commencez à créer.