Sandboxes Python client

cwsandbox Python クライアントは、CoreWeave のサンドボックス環境を作成および管理するための高レベルな SDK です。統一された API で、同期と非同期の両方のワークフローをサポートしています。

Python 環境を準備する

uv をインストールします。プロジェクトディレクトリで、Python 3.11 以降の既存の仮想環境を有効化するか、新しく作成します。

uv venv --python 3.12
source .venv/bin/activate

インストールコマンドとサンプルスクリプトは、この環境で実行してください。

認証を選択する

セクションで CKS が指定されていない限り、これらの例はサーバーレスキャパシティ上で実行されます。サンドボックスを所有するアカウントの認証情報を選択してください。キーまたはトークンの取得方法については、認証情報を選択して取得するを参照してください。使用する認証情報のタブにある Python コードを、このページで実行する Python スクリプトと同じディレクトリに sandbox_auth.py として保存します。このファイルに保存されるのは認証方法の選択のみで、認証情報そのものは含まれません。各例ではこのファイルから AUTH をインポートし、新しいサンドボックスやセッションを作成するたびに明示的に渡します。

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

SDK の W&B 認証方式で Forge APIキーを使用します。

uv pip install 'cwsandbox[wandb]>=1.14.2'
export WANDB_API_KEY="[WANDB-API-KEY]"

sandbox_auth.py

from cwsandbox import AuthStrategy

AUTH = AuthStrategy.WANDB

CoreWeave 組織のトークンを使用します。

uv pip install 'cwsandbox>=1.14.2'
export CWSANDBOX_API_KEY="[API-ACCESS-TOKEN]"

sandbox_auth.py

from cwsandbox import AuthStrategy

AUTH = AuthStrategy.COREWEAVE_API_KEY

CKS 配置を使用する場合は、CoreWeave トークンを選択し、ランナーを有効化したうえで、サンドボックスの作成時または SandboxDefaults で placement_mode="cks" を設定します。auth=AUTH を指定してセッションを作成すると、そのセッションが所有するサンドボックスも認証されます。サンドボックスへの再接続、一覧表示、クリーンアップを行う際も、同じ認証情報を使用してください。

クイックスタート

サンドボックスを作成し、コマンドを実行して、結果を取得します：

from sandbox_auth import AUTH
from cwsandbox import Sandbox

# 自動クリーンアップ用のコンテキストマネージャー
with Sandbox.run(
    container_image="python:3.11",
    resources={"cpu": "1", "memory": "1Gi"},
    auth=AUTH,
) as sb:
    result = sb.exec(["python", "-c", "print(2 + 2)"]).result()
    print(result.stdout)  # 4

非同期コードでは、Sandbox(...) を async with と組み合わせて使用すると、イベントループをブロックせずにサンドボックスを起動できます。Sandbox.run() は内部で start().result() を呼び出すため、起動処理の間はブロックされます。詳しくは、同期と非同期のパターンを参照してください。

from sandbox_auth import AUTH
from cwsandbox import Sandbox

async with Sandbox(resources={"cpu": "1", "memory": "1Gi"}, auth=AUTH) as sb:
    result = await sb.exec(["python", "-c", "print(2 + 2)"])
    print(result.stdout)  # 4

次のステップ

ターミナルから既存のサンドボックスを管理するには、CLI ガイドを参照してください。

はじめに

認証を行い、SDK を使って最初のサーバーレスサンドボックスを実行します。

チュートリアル

Python SDK を使って、サンドボックスの設定、コマンドの実行、ファイルの転送、クリーンアップを行う方法を学びます。

ガイド

ライフサイクル管理、ファイル操作、実行パターン、トラブルシューティングなど、特定のトピックについて詳しく説明します。

サンドボックス

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

サンドボックスの管理

リファレンス

Python 環境を準備する

認証を選択する

クイックスタート

次のステップ

はじめに

チュートリアル

ガイド

​Python 環境を準備する

​認証を選択する

​クイックスタート

​次のステップ

はじめに

チュートリアル

ガイド

Python 環境を準備する

認証を選択する

クイックスタート

次のステップ