Skip to main content

A framework for evaluating and optimizing agents and models using sandboxed environments.

Project description

Harbor

Docs

Harbor is a framework from the creators of Terminal-Bench for evaluating and optimizing agents and language models. You can use Harbor to:

  • Evaluate arbitrary agents like Claude Code, OpenHands, Codex CLI, and more.
  • Build and share your own benchmarks and environments.
  • Conduct experiments in thousands of environments in parallel through providers like Daytona and Modal.
  • Generate rollouts for RL optimization.

Installation

uv tool install harbor

or

pip install harbor

Example: Running Terminal-Bench-2.0

Harbor is the official harness for Terminal-Bench-2.0:

export ANTHROPIC_API_KEY=<YOUR-KEY> 
harbor run --dataset terminal-bench@2.0 \
   --agent claude-code \
   --model anthropic/claude-opus-4-1 \
   --n-concurrent 4 

This will launch the benchmark locally using Docker. To run it on a cloud provider (like Daytona) pass the --env flag as below:

export ANTHROPIC_API_KEY=<YOUR-KEY> 
export DAYTONA_API_KEY=<YOUR-KEY>
harbor run --dataset terminal-bench@2.0 \
   --agent claude-code \
   --model anthropic/claude-opus-4-1 \
   --n-concurrent 100 \
   --env daytona

To see all supported agents, and other options run:

harbor run --help

To explore all supported third party benchmarks (like SWE-Bench and Aider Polyglot) run:

harbor datasets list

To evaluate an agent and model one of these datasets, you can use the following command:

harbor run -d "<dataset@version>" -m "<model>" -a "<agent>"

Citation

If you use Harbor in academic work, please cite it using the “Cite this repository” button on GitHub or the following BibTeX entry:

@software{Harbor_Framework_Team_Harbor_A_framework_2026,
author = {{Harbor Framework Team}},
month = jan,
title = {{Harbor: A framework for evaluating and optimizing agents and models in container environments}},
url = {https://github.com/laude-institute/harbor},
year = {2026}
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

harbor-0.2.0a2.tar.gz (723.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

harbor-0.2.0a2-py3-none-any.whl (831.3 kB view details)

Uploaded Python 3

File details

Details for the file harbor-0.2.0a2.tar.gz.

File metadata

  • Download URL: harbor-0.2.0a2.tar.gz
  • Upload date:
  • Size: 723.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for harbor-0.2.0a2.tar.gz
Algorithm Hash digest
SHA256 d3a5eb904017a18f7bb7e85b2fdb91545d21b3a5e60e437dc36d8aeca15574d6
MD5 edce6a245f78124d1a31866fd78b04d6
BLAKE2b-256 fe1e698307d703779e98ac5984b28d5e8c3d1f1ab64d77e555cfd61dc518dbaf

See more details on using hashes here.

File details

Details for the file harbor-0.2.0a2-py3-none-any.whl.

File metadata

  • Download URL: harbor-0.2.0a2-py3-none-any.whl
  • Upload date:
  • Size: 831.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for harbor-0.2.0a2-py3-none-any.whl
Algorithm Hash digest
SHA256 d8cd8c720fc446f30fad80bccb967b1fcdbddcbade3315d2d767c88f1d44ebb5
MD5 15b3747eb9476d926451242aff6064eb
BLAKE2b-256 d3cb8b960d9a4b7a70de25670a2a453421cb057566779c59236f16dcc60fffe8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page