sandbox-cloud-client

Public client SDK for the Sandbox Cloud Platform — the SandboxCloudClient HTTP client plus the Harbor / SWE-ReX adapter layers, installable from public PyPI by any client (internal or external).

This is the server-free subset of the platform: it contains no FastAPI/uvicorn/JWT or control-plane code, so it installs with only httpx + pydantic.

Install

pip install sandbox-cloud-client
# with the real SWE-ReX runtime contract:
pip install "sandbox-cloud-client[swerex]"

No --extra-index-url / private index is required.

Migrating from 0.x

1.0.0 moves every public import under sandbox_cloud.client_sdk.* (monorepo top-level restructure). The module names and APIs are unchanged — only the prefix moved; there is no compatibility shim for the old paths:

Harbor --environment-import-path values change the same way: sandbox_cloud.plugins.harbor.environment:… → sandbox_cloud.client_sdk.plugins.harbor.environment:….

What's included

To drive a Harbor terminal-bench run against the platform, install the companion package and use Harbor's import-path extension point:

pip install harbor==0.6.6 sandbox-cloud-harbor-environment
export SANDBOX_CLOUD_PLATFORM_BASE_URL=https://your-platform-host
export SANDBOX_CLOUD_PLATFORM_API_KEY=...   # OIDC-only platform → Bearer
harbor run -d terminal-bench@2.0 \
    --environment-import-path sandbox_cloud_harbor_environment:SandboxCloudHarborEnvironment

Compatibility

• Python 3.11+
• httpx >= 0.27, pydantic >= 2
• swe-rex == 1.4.0 (via the swerex extra; without it, integrations.swerex falls back to local dataclasses)

License

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