サーバーレスサンドボックスを使ってみる

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

Run your first sandbox

W&B APIキーを取得します。アカウントをお持ちでない場合は、同じリンクからサインアップしてください。次に、ターミナルでキーを設定します。

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

Python
TypeScript

uv をインストールしたうえで、次の内容を 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)

Python 3.11 とサンドボックスクライアントを使用して実行します。これらがインストールされていない場合は、このコマンドによって自動的にインストールされます。

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

Node.js 22 以降をインストールしたうえで、クライアントをインストールします。

npm install @coreweave/cwsandbox

次の内容を 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);

tsx を使用して実行します。

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

これらの例では、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.

組織で W&B 専用クラウドを使用している場合は、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