Premiers pas avec CoreWeave Sandboxes

Exécutez une commande dans une sandbox sur une capacité sans serveur, puis affichez sa sortie. Aucune configuration de cluster n’est nécessaire.

Avant de commencer

Les sandboxes sans serveur sont en disponibilité générale, et leur utilisation est facturée. L’accès est activé pour chaque organisation. Pour demander l’accès pour votre organisation, contactez l’assistance. Si votre organisation utilise le Cloud dédié de W&B, consultez Utiliser les sandboxes avec le Cloud dédié de W&B.

Exécuter votre premier sandbox

Choisissez l’identifiant d’authentification du compte qui possède votre sandbox et auquel celui-ci est facturé. Une clé API Forge prend en charge le placement sans serveur. Un jeton d’accès à l’API CoreWeave prend en charge le placement sans serveur et sur CoreWeave Kubernetes Service (CKS). Pour connaître les exigences relatives au compte, consultez Choisir et obtenir des identifiants d’authentification. Sélectionnez l’onglet correspondant à votre identifiant d’authentification, puis vérifiez le résultat.

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

Obtenez votre clé API Forge. Si vous n’avez pas de compte, inscrivez-vous via le même lien. Définissez ensuite la clé dans votre terminal. Ces exemples sélectionnent explicitement l’authentification W&B :

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

Python
TypeScript

Une fois uv installé, enregistrez ce code dans 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)

Exécutez-le avec Python 3.11 et le client sandbox, que la commande installe au besoin :

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

Une fois Node.js 22 (ou version ultérieure) installé, installez le client :

npm install @coreweave/cwsandbox@1.0.0

Enregistrez ce code dans 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);

Exécutez-le avec tsx :

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

La clé API Forge s’appuie sur les identifiants W&B existants du SDK : WANDB_API_KEY, AuthStrategy.WANDB et le point d’entrée TypeScript /wandb.

Demandez à votre administrateur de créer ou de mettre à jour une politique d’accès qui vous attribue le rôle Sandbox User. Pour connaître la procédure, voir Créer une politique d’accès.Créez un jeton d’accès à l’API sur la page Tokens, copiez son Token Secret, puis définissez-le dans votre terminal :

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

Python
TypeScript

Une fois uv installé, enregistrez ce code dans 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)

Exécutez-le avec Python 3.11 et le client sandbox, que la commande installe au besoin :

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

Une fois Node.js 22 (ou version ultérieure) installé, installez le client :

npm install @coreweave/cwsandbox@1.0.0

Enregistrez ce code dans 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);

Exécutez-le avec tsx :

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

Vérifier le résultat

L’exemple affiche la sortie suivante, puis arrête la sandbox une fois son exécution terminée :

Output

Hello!

Le sandbox dispose de 1 CPU et de 1 Gio de mémoire. Le dictionnaire plat resources attribue les mêmes valeurs aux demandes de ressources et aux limites de CPU et de mémoire. Modifiez resources pour choisir son CPU et sa mémoire. Pour en savoir plus sur les quotas de simultanéité, les limites de débit des requêtes de création et les erreurs de quota, voir Limites et quotas.

Étapes suivantes

Poursuivez avec le guide adapté à votre charge de travail :

Utiliser votre propre capacité de calcul : activez un exécuteur sur votre cluster et exécutez-y une sandbox.
Placement des sandboxes et débordement : comparez la capacité sans serveur et la capacité CKS, puis configurez le basculement.
Exécuter des agents de développement : connectez un agent de développement à une sandbox.
Sandboxes GPU : demandez l’accès aux GPU et exécutez une charge de travail GPU.
Client Python : exécutez des commandes, manipulez des fichiers et configurez des sandboxes.
Client TypeScript : exécutez des commandes, utilisez des fichiers Compose et consultez l’API du SDK.

Sandbox

Utiliser les Sandbox

Gérer les bacs à sable

Référence

Premiers pas avec CoreWeave Sandboxes

Avant de commencer

Exécuter votre premier sandbox

Vérifier le résultat

Étapes suivantes

​Avant de commencer

​Exécuter votre premier sandbox

​Vérifier le résultat

​Étapes suivantes

Avant de commencer

Exécuter votre premier sandbox

Vérifier le résultat

Étapes suivantes