Client Python Sandboxes

Le client Python cwsandbox fournit un SDK de haut niveau permettant de créer et de gérer des environnements de bac à sable CoreWeave. Grâce à une API unifiée, il prend en charge les flux de travail synchrones comme asynchrones.

Préparer votre environnement Python

Installez uv. Dans le répertoire de votre projet, activez un environnement virtuel existant utilisant Python 3.11 ou une version ultérieure, ou créez-en un :

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

Exécutez les commandes d’installation et les scripts d’exemple depuis cet environnement.

Choisir l’authentification

Ces exemples s’exécutent sur la capacité sans serveur, sauf si une section indique CKS. Choisissez l’identifiant d’authentification du compte propriétaire de vos Sandbox. Consultez Choisir et obtenir des identifiants d’authentification pour obtenir une clé ou un jeton. Enregistrez le code Python de l’onglet correspondant à votre identifiant d’authentification sous le nom sandbox_auth.py, dans le même répertoire que les scripts Python que vous exécutez depuis cette page. Ce fichier enregistre la méthode d’authentification choisie, et non votre identifiant d’authentification lui-même. Les exemples importent AUTH depuis ce fichier et le transmettent explicitement à chaque nouvelle Sandbox ou session.

Clé API Forge
Jeton d’accès à l’API CoreWeave

Utilisez votre clé API Forge via la stratégie d’authentification W&B du SDK :

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

Utilisez le jeton de votre organisation 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

Pour un placement sur CKS, choisissez le jeton CoreWeave, activez un exécuteur et définissez placement_mode="cks" lors de la création de la Sandbox ou dans SandboxDefaults. Lorsque vous créez une session avec auth=AUTH, les Sandbox qui lui appartiennent sont également authentifiés. Utilisez le même identifiant d’authentification pour vous reconnecter à vos Sandbox, les lister ou les nettoyer.

Démarrage rapide

Créez une sandbox, exécutez une commande et récupérez le résultat :

from sandbox_auth import AUTH
from cwsandbox import Sandbox

# Gestionnaire de contexte pour un nettoyage automatique
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

Dans du code asynchrone, utilisez Sandbox(...) avec async with pour démarrer la sandbox sans bloquer la boucle d’événements. Sandbox.run() appelle start().result() en interne, ce qui bloque l’exécution pendant le démarrage. Voir Modèles synchrones et asynchrones.

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

Prochaines étapes

Consultez le guide de la CLI pour gérer les sandboxes existantes depuis votre terminal.

Premiers pas

Authentifiez-vous et lancez votre première sandbox sans serveur avec le SDK.

Tutoriel

Apprenez à configurer des sandboxes, à exécuter des commandes, à transférer des fichiers et à nettoyer les ressources avec le SDK Python.

Guides

Guides approfondis sur des sujets précis, notamment la gestion du cycle de vie, les opérations sur les fichiers, les modèles d’exécution et le dépannage.

Sandbox

Utiliser les Sandbox

Gérer les bacs à sable

Référence

Préparer votre environnement Python

Choisir l’authentification

Démarrage rapide

Prochaines étapes

Premiers pas

Tutoriel

Guides

​Préparer votre environnement Python

​Choisir l’authentification

​Démarrage rapide

​Prochaines étapes

Premiers pas

Tutoriel

Guides

Préparer votre environnement Python

Choisir l’authentification

Démarrage rapide

Prochaines étapes