Skip to main content

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.

Agent kwarg (--ak) Default Meaning
reasoning_effort medium minimal, low, medium, high, xhigh or max
mode ephemeral ephemeral: a new single-use workspace per trial, with memory and skills on. standard: your own workspace
runtime_profile runtime/reason-v7-2026-10 in ephemeral mode; the server default in standard mode A harness listed by GET /v3/deployment. The default is Reason's harness as it ran in October 2026, frozen, and its trials install the CLI it froze with (0.2.151) instead of the newest one; runtime/reason-c2-tools-v7 runs the deployment's current default instead

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.

Metadata

Release files for reason-machines-harbor 0.3.25

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for reason-machines-harbor 0.3.25
File Size Uploaded Provenance
reason_machines_harbor-0.3.25.tar.gz 218.6 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for reason-machines-harbor 0.3.25
File Interpreter ABI Platform
reason_machines_harbor-0.3.25-py3-none-any.whl Python 3 none any Details

Total release size: 264.7 kB

Release files / reason_machines_harbor-0.3.25.tar.gz

Download URL reason_machines_harbor-0.3.25.tar.gz
Size 218.6 kB
Tags Source
SHA-256 checksum
How to use checksums
1bb0064caabb1849b7be2a66e532a072a1ec40377e4703fb60ef79fd286d62ca
BLAKE2b-256 checksum
How to use checksums
5304f6f69adf5c288c4d4e72b21ec74fff2ce9f66851d5e24e4697f0fd531737
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.

Transparency log

Release files / reason_machines_harbor-0.3.25-py3-none-any.whl

Download URL reason_machines_harbor-0.3.25-py3-none-any.whl
Size 46.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
610546ae0e02556811ec31bc63c9072cea8d6b5831d4ee9cceb925cef2cc7abb
BLAKE2b-256 checksum
How to use checksums
025afd6ec51eaacfef77a446a8484ba8857c1320d918f82648592db9f0167c96
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.

Transparency log

Security for reason-machines-harbor 0.3.25

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for reason_machines_harbor-0.3.25.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page