sandbox-cloud-harbor-environment

Harbor environment plugin for Sandbox Cloud Platform.

Lets Harbor users run benchmark jobs (e.g. terminal-bench 2.0) against the Sandbox Cloud Platform with the same UX as other Harbor cloud environments. Installable from public PyPI — no company-private index required. This package owns only the Harbor-side adapter (a BaseEnvironment implementation); the platform itself is not included.

Installation

uv tool install harbor --with sandbox-cloud-harbor-environment

or with pip in a Python 3.12 environment:

pip install harbor==0.6.6 sandbox-cloud-harbor-environment

This pulls the public sandbox-cloud-client SDK automatically.

Usage

Set your connection details in environment variables:

export SANDBOX_CLOUD_PLATFORM_BASE_URL=https://your-platform-host
export SANDBOX_CLOUD_PLATFORM_API_KEY=scp...

Run a Harbor benchmark using the import-path extension point:

harbor run -d terminal-bench@2.0 \
    --environment-import-path sandbox_cloud_harbor_environment:SandboxCloudHarborEnvironment

Why --environment-import-path and not --env sandbox-cloud-platform?

Harbor 0.6.6's --env flag only accepts values from the built-in EnvironmentType enum (docker, daytona, e2b, …). External packages installed via --with cannot add new enum values at runtime. The official Harbor extension point for custom environments is --environment-import-path, which accepts any module.path:ClassName importable in the tool's virtual environment.

Environment variables

Compatibility

• Python 3.12+
• harbor 0.6.6
• depends on sandbox-cloud-client >= 1.0.0, < 2 (public PyPI)

Troubleshooting

Import error: sandbox_cloud not found The sandbox-cloud-client package provides the sandbox_cloud.* client modules and is a declared dependency; pip install sandbox-cloud-harbor-environment pulls it from public PyPI. If you see this, reinstall in a clean environment.

HTTPStatusError 401 Unauthorized Set SANDBOX_CLOUD_PLATFORM_API_KEY to a valid API key. (Note: the in-repo sandbox_cloud.client_sdk.plugins.harbor.environment import-path does NOT send an auth header — use this package's import-path, which forwards Authorization: Bearer.)

Connection refused / Cannot connect to host Set SANDBOX_CLOUD_PLATFORM_BASE_URL to the correct platform URL and confirm the platform host is reachable from your network.

Harbor version mismatch This package targets harbor==0.6.6. Other versions may work but are not tested. Pin harbor==0.6.6 if you encounter compatibility issues:

uv tool install harbor==0.6.6 --with sandbox-cloud-harbor-environment

Common change patterns

Adapter behavior changes land in the platform monorepo (this package's directory there) and ship via a per-package tag (#349): bump only THIS package's pyproject.toml version, then push harbor-env-vX.Y.Z (must equal the pyproject version — the publish workflow's release-tag guard refuses a mismatch and publishes only this dist). sandbox-cloud-client has its own independent line and client-vX.Y.Z tags; the retired repo-wide v* scheme no longer triggers any publish. This README documents usage only.

License

MPL-2.0 — source-available; modifications permitted, modified covered files' source published on distribution (file-level copyleft).