Exécuter Devin Outposts sur des Sandboxes

​

Prérequis

• Une organisation Devin dans laquelle les Outposts sont activés. Si Outposts n’apparaît pas sous Settings > Environment dans Devin Cloud, adressez-vous à votre administrateur Devin.
• Un jeton d’accès à l’API CoreWeave disposant de l’action SANDBOX_USER.
• Pour une utilisation directe du kit de développement logiciel (SDK), Python 3.11 ou version ultérieure avec uv, ou Node.js 22 ou version ultérieure.

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

​

Créer un avant-poste dans Devin Cloud

1. Dans Devin Cloud, accédez à Settings > Environment > Outposts.
2. Cliquez sur Create Outpost, saisissez un nom, puis sélectionnez Linux.
3. Copiez le jeton de l’avant-poste. Devin Cloud ne l’affiche qu’une seule fois.

​

Démarrage rapide avec cws-agent

export DEVIN_OUTPOSTS_TOKEN="[OUTPOST-TOKEN]"
cws-agent launch [SANDBOX-NAME] --outpost [OUTPOST-NAME]

cws-agent connect [SANDBOX-NAME] --cmd 'tmux attach -t outpost-0'

​

Configurer avec le SDK Sandboxes

​

Configurer les identifiants et installer le client

export DEVIN_OUTPOSTS_TOKEN="[OUTPOST-TOKEN]"

uv venv --python 3.11
source .venv/bin/activate
uv pip install 'cwsandbox>=1.14.2'

npm install @coreweave/cwsandbox@0.5.0-beta.0 tsx

​

Démarrer le worker

import os
import sys

from cwsandbox import ResourceOptions, Sandbox

outpost = sys.argv[1]

# L’image du worker inclut la CLI Devin mais pas git, dont Devin a besoin pour
# cloner les dépôts. Installez-le, puis confiez le processus au worker.
command = """
apt-get update -qq
DEBIAN_FRONTEND=noninteractive apt-get install -y -qq git ca-certificates >/dev/null
mkdir -p /workspace
cd /workspace
exec devin worker start --outpost="$DEVIN_OUTPOST"
"""

sandbox = Sandbox.run(
    "bash", "-ec", command,
    container_image="public.ecr.aws/e0h8a4b6/devin-cli:stable",
    environment_variables={
        "DEVIN_OUTPOSTS_TOKEN": os.environ["DEVIN_OUTPOSTS_TOKEN"],
        "DEVIN_OUTPOST": outpost,
    },
    max_lifetime_seconds=8 * 3600,
    resources=ResourceOptions(
        requests={"cpu": "2", "memory": "4Gi"},
        limits={"cpu": "2", "memory": "4Gi"},
    ),
    tags=["devin-outpost-worker"],
)
try:
    sandbox.wait()
except BaseException:
    sandbox.stop().result()
    raise

print(f"Worker sandbox ID: {sandbox.sandbox_id}")

import { createSandboxClientFromEnv } from "@coreweave/cwsandbox/node";

const token = process.env.DEVIN_OUTPOSTS_TOKEN;
if (!token) throw new Error("Set DEVIN_OUTPOSTS_TOKEN.");
const outpost = process.argv[2];
if (!outpost) throw new Error("Pass an outpost name.");

const command = `
apt-get update -qq
DEBIAN_FRONTEND=noninteractive apt-get install -y -qq git ca-certificates >/dev/null
mkdir -p /workspace
cd /workspace
exec devin worker start --outpost="$DEVIN_OUTPOST"
`;

const client = createSandboxClientFromEnv();
const sandbox = await client.run(["bash", "-ec", command], {
  containerImage: "public.ecr.aws/e0h8a4b6/devin-cli:stable",
  environmentVariables: {
    DEVIN_OUTPOSTS_TOKEN: token,
    DEVIN_OUTPOST: outpost,
  },
  resources: { cpu: "2", memory: "4Gi" },
  maxLifetimeSeconds: 8 * 3600,
  waitUntilRunning: false,
  tags: ["devin-outpost-worker"],
});
try {
  await sandbox.wait();
} catch (error) {
  await sandbox.stop();
  throw error;
}
console.log(`Worker sandbox ID: ${sandbox.sandboxId}`);

python start_outpost_worker.py [OUTPOST-NAME]

npx tsx start_outpost_worker.mts [OUTPOST-NAME]

​

Facultatif : utiliser un magasin de secrets

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

import os

from cwsandbox import AuthHeaders

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

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

const client = createSandboxClient({
  apiKey: process.env.FORGE_API_KEY,
  entity: process.env.FORGE_TEAM,
});

​

Exécuter et vérifier une session Devin

@Devin !outpost [OUTPOST-NAME] Write the exact text [PROOF-VALUE] to /workspace/outpost-proof.txt and read the file back. Report its contents.

cws-agent exec [SANDBOX-NAME] 'cat /workspace/outpost-proof.txt'

from cwsandbox import Sandbox

sandbox = Sandbox.from_id("[SANDBOX-ID]").result()
result = sandbox.exec(["cat", "/workspace/outpost-proof.txt"], check=True).result()
print(result.stdout, end="")

import { createSandboxClientFromEnv } from "@coreweave/cwsandbox/node";

const client = createSandboxClientFromEnv();
const sandbox = await client.fromId("[SANDBOX-ID]");
const result = await sandbox.commands.run(["cat", "/workspace/outpost-proof.txt"], { check: true });
process.stdout.write(result.stdout);

​

Vérifier le worker et l’arrêter

from cwsandbox import Sandbox

sandbox = Sandbox.from_id("[SANDBOX-ID]").result()
print("Sandbox status:", sandbox.get_status())
for container in sandbox.container_statuses:
    print(container.name, container.state, container.exit_code, container.restart_count)
for line in sandbox.stream_logs(tail_lines=100):
    print(line, end="")

import { createSandboxClientFromEnv } from "@coreweave/cwsandbox/node";

const client = createSandboxClientFromEnv();
const sandbox = await client.fromId("[SANDBOX-ID]");
console.log("Sandbox status:", sandbox.status, "Exit code:", sandbox.exitCode);
for (const line of await sandbox.logs.read({ tailLines: 100 })) {
  process.stdout.write(line);
}

cws-agent down [SANDBOX-NAME]

from cwsandbox import Sandbox

sandbox = Sandbox.from_id("[SANDBOX-ID]").result()
sandbox.stop().result()

import { createSandboxClientFromEnv } from "@coreweave/cwsandbox/node";

const client = createSandboxClientFromEnv();
const sandbox = await client.fromId("[SANDBOX-ID]");
await sandbox.stop();

​

Facultatif : personnaliser l’environnement

• Utilisez votre propre image. L’image officielle contient la CLI devin et presque rien d’autre. Compilez à partir de celle-ci une image qui ajoute votre chaîne d’outils, puis transmettez-la via container_image en Python ou containerImage en TypeScript. Devin nécessite git. L’enregistrement d’écran nécessite ffmpeg, et les outils de navigateur et d’utilisation de l’ordinateur nécessitent un binaire de navigateur compatible. Pour les images amd64 basées sur l’image Ubuntu officielle, installez Google Chrome. Le paquet chromium d’Ubuntu n’est qu’un stub snap qui ne fonctionne pas dans les conteneurs. Voir la configuration du conteneur Devin. L’utilisation de l’ordinateur nécessite également un affichage graphique actif, tel que Xvfb, avec la variable DISPLAY définie pour le worker. Le worker effectue sa recherche dans les emplacements d’installation standard. S’il ne trouve pas votre binaire, définissez DEVIN_CHROME_PATH sur son chemin absolu. Voir la référence Devin Outposts.
• Configurez des GPU. Pour connaître les options disponibles, voir la configuration GPU des sandbox. L’exemple de worker de ce guide utilise uniquement des ressources CPU.
• Exécutez davantage de workers. Un worker ne sert qu’une session à la fois. Exécutez de nouveau le script avec le même nom d’avant-poste pour démarrer un autre worker sur la file d’attente.
• Créez une sandbox par session. Ici, le worker réutilise sa sandbox d’une session à l’autre. Pour obtenir une nouvelle sandbox à chaque session, consultez le guide d’orchestration de Devin.