CoreWeave Sandboxes を使い始める

サーバーレスキャパシティ上のサンドボックスでコマンドを実行し、その出力を表示します。クラスターのセットアップは必要ありません。

始める前に

サーバーレスサンドボックスは一般提供されており、使用量に応じて課金されます。アクセスは組織単位で有効化されます。組織のアクセスをリクエストするには、サポートにお問い合わせください。組織で W&B 専用クラウドを使用している場合は、W&B 専用クラウドでサンドボックスを使用するの手順に従ってください。

最初のサンドボックスを実行する

サンドボックスを所有し、その料金の請求先となるアカウントの認証情報を選択します。Forge APIキーはサーバーレスへの配置をサポートしています。CoreWeave API アクセストークンは、サーバーレスと CoreWeave Kubernetes Service (CKS) の両方への配置をサポートしています。アカウントの要件については、認証情報を選択して取得するを参照してください。使用する認証情報のタブを選択し、手順を実行してから、結果を検証してください。

Forge API キー
CoreWeave API アクセストークン

Forge API キーを取得します。アカウントをお持ちでない場合は、同じリンクから新規登録してください。次に、ターミナルでキーを設定します。以下の例では、W&B 認証を明示的に指定しています。

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.14.2' hello.py

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

npm install @coreweave/cwsandbox@1.0.0

次の内容を hello.mts として保存します。

hello.mts

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

const client = createSandboxClient({
  apiKey: process.env.WANDB_API_KEY,
});
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

Forge API キーでは、SDK の既存の W&B 識別子 (WANDB_API_KEY、AuthStrategy.WANDB、TypeScript の /wandb エントリポイント) をそのまま使用します。

Sandbox User ロールを付与するアクセスポリシーの作成または更新を管理者に依頼してください。手順については、アクセスポリシーを作成するを参照してください。Tokens ページで API アクセストークンを作成し、その Token Secret をコピーして、ターミナルで設定します。

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

Python
TypeScript

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

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

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

npm install @coreweave/cwsandbox@1.0.0

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

tsx で実行します。

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

結果を確認する

このサンプルを実行すると次の出力が表示され、処理の完了時にサンドボックスが停止します。

Output

Hello!

このサンドボックスには 1 CPU と 1 GiB のメモリが割り当てられています。フラットな resources 辞書では、CPU とメモリのリクエスト値と制限値が同じ値に設定されます。CPU とメモリを変更するには、resources を変更します。同時実行数のクォータ、作成リクエストのレート制限、クォータエラーについては、制限とクォータを参照してください。

次のステップ

ワークロードに応じて、以下のガイドに進んでください。

独自のコンピュートを使用する: クラスターでランナーを有効にし、そのクラスター上でサンドボックスを実行します。
サンドボックスの配置とスピルオーバー: サーバーレスと CKS のキャパシティを比較し、フォールバックを設定します。
コーディングエージェントを実行する: コーディングエージェントをサンドボックスに接続します。
GPU サンドボックス: GPU へのアクセスをリクエストし、GPU ワークロードを実行します。
Python クライアント: コマンドの実行、ファイルの操作、サンドボックスの設定を行います。
TypeScript クライアント: コマンドの実行や Compose ファイルの使用方法を確認し、SDK API を参照できます。

サンドボックス

サンドボックスを使用する

サンドボックスの管理

リファレンス

CoreWeave Sandboxes を使い始める

始める前に

最初のサンドボックスを実行する

結果を確認する

次のステップ

​始める前に

​最初のサンドボックスを実行する

​結果を確認する

​次のステップ

始める前に

最初のサンドボックスを実行する

結果を確認する

次のステップ