Get started with CoreWeave Sandboxes

Run a command in a sandbox on serverless capacity and print its output. No cluster setup is required.

Before you begin

Serverless sandboxes are generally available, and usage is billed. Access is enabled per organization. To request access for your organization, contact support. If your organization uses Forge Dedicated Cloud, follow Use sandboxes with Forge Dedicated Cloud.

Run your first sandbox

Choose the credential for the account that owns and is billed for your sandbox. A Forge API key supports serverless placement. A CoreWeave API access token supports serverless and CoreWeave Kubernetes Service (CKS) placement. For account requirements, see Choose and get credentials. Follow the section for your credential, then verify the result.

Forge API key

Get your Forge API key. If you don’t have an account, sign up through the same link. Then set the key in your terminal. The examples explicitly read FORGE_API_KEY; the SDK does not detect this variable automatically:

export FORGE_API_KEY="[FORGE-API-KEY]"

Python
TypeScript

With uv installed, save this as hello.py:

hello.py

import os
from cwsandbox import AuthHeaders, Sandbox

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

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

Run it with Python 3.11 and the sandbox client. The command installs them if needed:

uv run --python 3.11 --with 'cwsandbox>=1.14.2' hello.py

With Node.js 22 or later installed, install the client:

npm install @coreweave/cwsandbox

Save this as hello.mts:

hello.mts

import { createSandboxClient } from "@coreweave/cwsandbox/wandb";

const client = createSandboxClient({
  apiKey: process.env.FORGE_API_KEY,
});
const result = await client.withSandbox(
  async (sandbox) => sandbox.commands.run(["echo", "Hello!"]),
  { resources: { cpu: "1", memory: "1Gi" } },
);
console.log(result.stdout);

Run it with tsx:

npx --yes --package=tsx tsx hello.mts

The x-wandb-api-key header, wandb_api_key strategy identifier, and TypeScript /wandb entry point are the current SDK identifiers for Forge authentication. Keep these identifiers as written.

CoreWeave API access token

Ask your administrator to create or update an Access Policy granting you the Sandbox User role. See Create an access policy for the steps. Create an API access token on the Tokens page, copy its Token Secret, and set it in your terminal:

export CWSANDBOX_API_KEY="[API-ACCESS-TOKEN]"

Python
TypeScript

With uv installed, save this as hello.py:

hello.py

from cwsandbox import AuthStrategy, Sandbox

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

Run it with Python 3.11 and the sandbox client. The command installs them if needed:

uv run --python 3.11 --with 'cwsandbox>=1.10.0' hello.py

With Node.js 22 or later installed, install the client:

npm install @coreweave/cwsandbox

Save this as hello.mts:

hello.mts

import { createSandboxClientFromEnv } from "@coreweave/cwsandbox/node";

const client = createSandboxClientFromEnv();
const result = await client.withSandbox(
  async (sandbox) => sandbox.commands.run(["echo", "Hello!"]),
  { resources: { cpu: "1", memory: "1Gi" } },
);
console.log(result.stdout);

Run it with tsx:

npx --yes --package=tsx tsx hello.mts

Verify the result

The example prints the following output and stops the sandbox when it finishes:

Output

Hello!

The sandbox has 1 CPU and 1 GiB of memory. Serverless sets resource limits equal to requests. Change resources to choose its CPU and memory. For concurrent quotas, rate limits on create requests, and quota errors, see Limits and quotas.

Next steps

Continue with the guide for your workload:

Use your own compute: enable a runner on your cluster and run a sandbox there.
Sandbox placement and spillover: compare serverless and CKS capacity and configure fallback.
Run coding agents: connect a coding agent to a sandbox.
GPU sandboxes: request GPU access and run a GPU workload.
Python client: execute commands, work with files, and configure sandboxes.

Sandboxes

Use sandboxes

Manage sandboxes

Reference

Get started with CoreWeave Sandboxes

Before you begin

Run your first sandbox

Forge API key

CoreWeave API access token

Verify the result

Next steps

​Before you begin

​Run your first sandbox

​Forge API key

​CoreWeave API access token

​Verify the result

​Next steps

Before you begin

Run your first sandbox

Forge API key

CoreWeave API access token

Verify the result

Next steps