서버리스 샌드박스 시작하기

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 Dedicated Cloud를 사용한다면 W&B Dedicated Cloud에서 샌드박스 사용하기를 참조하세요.

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