Use sandboxes with W&B Dedicated Cloud

​

Before you begin

• Sandbox access enabled for your Dedicated Cloud instance. Contact your account team to confirm that your instance has the required server updates and to request access.
• The URL of your Dedicated Cloud instance, for example https://[INSTANCE].wandb.io. The hostname must end in .wandb.io. Instances on custom domains aren’t supported.
• Python 3.11 or newer.

​

Get an API key from your instance

1. Sign in to your Dedicated Cloud instance.
2. Click your user profile icon, then click User Settings.
3. Scroll to the API Keys section and create a key.

​

Configure instance authentication

uv pip install 'cwsandbox>=1.14.2'

export FORGE_HOST="[INSTANCE].wandb.io"
export WANDB_API_KEY="[WANDB-API-KEY]"

​

Run a sandbox

import os
from cwsandbox import AuthHeaders, Sandbox

forge_auth = AuthHeaders(
    headers={
        "x-wandb-api-key": os.environ["WANDB_API_KEY"],
        "x-wandb-host": os.environ["FORGE_HOST"],
    },
    strategy="wandb_api_key",
)

with Sandbox.run(
    auth=forge_auth,
    resources={"cpu": "1", "memory": "1Gi"},
) as sandbox:
    result = sandbox.exec(["echo", "Hello!"]).result()
    print(result.stdout)

​

Next steps

• Get started with CoreWeave sandboxes covers placement modes, credentials, and spillover.
• The Python client documentation covers lifecycle, execution, file operations, and other SDK patterns.