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é Forge, consultez Utiliser les sandboxes avec le Cloud dédié Forge.

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. Suivez la section qui correspond à votre identifiant d’authentification, puis vérifiez le résultat.

Clé API Forge

Obtenez votre clé API Forge. Si vous n’avez pas de compte, inscrivez-vous via ce même lien. Définissez ensuite la clé dans votre terminal. Les exemples lisent explicitement FORGE_API_KEY ; le SDK ne détecte pas cette variable automatiquement :

export FORGE_API_KEY="[FORGE-API-KEY]"

Python
TypeScript

Une fois uv installé, enregistrez ce code sous le nom hello.py :

hello.py

import os
from cwsandbox import AuthHeaders, Sandbox

forge_auth = AuthHeaders(
    headers={"x-wandb-api-key": os.environ["FORGE_API_KEY"]},
    strategy="wandb_api_key",
)

with Sandbox.run(
    auth=forge_auth,
    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.14.2' hello.py

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

npm install @coreweave/cwsandbox

Enregistrez ce code sous le nom hello.mts :

hello.mts

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

const client = createSandboxClient({
  apiKey: process.env.FORGE_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

L’en-tête x-wandb-api-key, l’identifiant de stratégie wandb_api_key et le point d’entrée TypeScript /wandb sont les identifiants actuels du SDK pour l’authentification Forge. Conservez-les tels quels.

Jeton d’accès à l’API CoreWeave

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

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. En mode sans serveur, les limites de ressources sont égales aux demandes de ressources. 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.

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

Clé API Forge

Jeton d’accès à l’API CoreWeave

Vérifier le résultat

Étapes suivantes

​Avant de commencer

​Exécuter votre premier sandbox

​Clé API Forge

​Jeton d’accès à l’API CoreWeave

​Vérifier le résultat

​Étapes suivantes

Avant de commencer

Exécuter votre premier sandbox

Clé API Forge

Jeton d’accès à l’API CoreWeave

Vérifier le résultat

Étapes suivantes