Reason Harbor adapter

Run Reason as an agent in Harbor. Harbor starts the task container and grades the result. The adapter installs the published Reason CLI in that container, checks its checksum, and starts it as a worker; the agent runs as a normal Reason Session. Your API key stays on your machine; the container only receives a one-use enrollment ticket.

Install

uv pip install reason-machines-harbor

This installs Harbor 0.22.0. For cloud environments, add the matching Harbor extra, for example uv pip install "harbor[modal]==0.22.0".

Run

Get a Reason API key with run, sessions:read, deployment:read, devices:read, devices:write, devices:use and org:write, and enable the model under Models.

export REASON_API_KEY="YOUR_REASON_API_KEY"
DOCKER_DEFAULT_PLATFORM=linux/amd64 harbor run \
  --dataset datacurve/deep-swe-1-1 --n-tasks 1 \
  --agent reasonmachines_harbor:ReasonAgent \
  --model openai/gpt-6-luna \
  --ak reasoning_effort=xhigh \
  --allow-agent-host api.reasonmachines.com \
  --allow-agent-host relay.reasonmachines.com \
  --env reasonmachines_harbor.environment:ReasonDockerEnvironment

The worker connects out to the Reason API and relay, so both --allow-agent-host flags are required, even for offline tasks.

Ephemeral mode needs an owner or admin key of a workspace with paid model access. To bill the model to your own provider account, connect its API key under Models and pass the model as byok:<provider>:<model>, for example byok:openai:gpt-6-luna.

To run the full benchmarks and reproduce our results, see reason-machines/benchmark.

Source

reason-machines/reason-machines-harbor is a read-only copy of the adapter in the Reason monorepo, where it is developed and tested. Releases are tagged vX.Y.Z.