Skip to main content

Install

Agent Harness currently supports three installation modes only:

  • npm
  • Docker Compose
  • local-source development mode

Everything in the first-run docs and examples maps back to one of those three paths.

npm

Use this when you want the fastest CLI-first path.

npm install
npm run harness -- init --profile local
npm run harness -- doctor

Docker Compose

Use this when you want controller, workers, and UI packaged together.

docker compose up --build

Local-source development

Use this when changing the harness itself.

npm install
npm run harness -- doctor
npm test

✦Offline validation

If you are only validating config shape and local paths before starting model or Brain services, run harness doctor with --skip-model-endpoint --skip-agent-brain.