Use sandboxes with Forge Dedicated Cloud

​

Before you begin

• Sandbox access enabled for your Forge Dedicated Cloud instance. Contact your Forge account team to confirm that your instance has the required server updates and to request access.
• The URL of your Forge 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 Forge 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 FORGE_API_KEY="[FORGE-API-KEY]"

​

Run a sandbox

import os
from cwsandbox import AuthHeaders, Sandbox

forge_auth = AuthHeaders(
    headers={
        "x-wandb-api-key": os.environ["FORGE_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.