Premiers pas avec les sandboxes serverless

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

Run your first sandbox

Obtenez votre clé API W&B. Si vous n’avez pas de compte, inscrivez-vous à partir de ce même lien. Définissez ensuite la clé dans votre terminal :

export WANDB_API_KEY="[WANDB-API-KEY]"

Python
TypeScript

Une fois uv installé, enregistrez ce code sous le nom hello.py :

hello.py

from cwsandbox import AuthStrategy, Sandbox

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

Exécutez-le avec Python 3.11 et le client sandbox. La commande les installe si nécessaire :

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

Une fois Node.js 22 ou une version ultérieure installée, installez le client :

npm install @coreweave/cwsandbox

Enregistrez ce code sous le nom hello.mts :

hello.mts

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

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

Exécutez-le avec tsx :

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

Ces exemples utilisent une clé issue de wandb.ai. 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.

Serverless Sandboxes is generally available, and usage is billed. Access is enabled per organization. To request access for your organization, contact support.

Si votre organisation utilise le Cloud dédié W&B, consultez Utiliser des sandboxes avec le Cloud dédié W&B.

Next steps

Continue with the guide for your workload:

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.

​Run your first sandbox

​Next steps

Run your first sandbox

Next steps