Français
Commencer

Agent Sandboxes Duplication, mémoire comprise

Dupliquer une sandbox active, mémoire comprise

Préparez un environnement une fois, un dépôt cloné, ses dépendances installées, un serveur lancé, un agent à mi-chemin d’une tâche, puis copiez-le en entier, mémoire et processus compris, et essayez plein de choses à partir de ce même point.

Ce qu’est une duplication

fork_sandbox copie une sandbox telle qu’elle est à cet instant, sa mémoire, ses processus et son disque, dans de nouvelles sandboxes actives en un appel, autant que son serveur a de place et 100 au plus. Chaque copie poursuit seule à partir du moment de la duplication : les mêmes fichiers, les mêmes programmes dans le même état, une session Python avec ses variables, un serveur avec son port ouvert. Les agents sont copiés aussi : la conversation d’un agent de code est sur le disque de la sandbox, donc chaque copie peut recevoir un prompt là où en était la source.

C’est ce dont ont besoin le RL et les évaluations : un état préparé, de nombreuses tentatives à partir de lui, sans qu’aucune ne repaie le clone, l’installation ou les premières étapes de la tâche.

Comment marche la duplication d’une sandbox

Les copies sont créées sur le serveur de la source. Une source active est copiée pendant qu’elle tourne, puis se met en pause quelques millisecondes, le temps de capturer sa mémoire, et repart : 18 à 56 ms pour une source dont le disque était très fragmenté. Une source en pause reste en pause, et les copies d’une source arrêtée partent de son disque. Chaque copie est restaurée à partir de reflinks de cette capture, puis écrit sa propre mémoire et son propre disque. Mesuré : une copie en 258 ms via l’API, trois en 247 ms sur le serveur.

Une duplication, c’est tout ou rien. Quand le serveur n’a pas de place pour toutes les copies, rien n’est créé et l’appel dit combien tiendraient (NoCapacity), pour que vous puissiez en redemander autant. Les copies ont la taille de la source, avec son disque ; vous pouvez leur donner leurs propres labels et d’autres groupes de paramètres : trafic sortant, ports, environnement, délais d’inactivité.

Ce que chaque copie reçoit de neuf, et ce qu’elle garde

Chaque copie a son propre ID, son ID comme nom d’hôte, son propre machine-id et son propre aléa noyau : le noyau est réensemencé à la restauration. Les générateurs aléatoires à l’intérieur des programmes, c’est autre chose. Ceux d’OpenSSL, le Math.random de V8, le random de Python et le math/rand de Go ont été copiés avec la mémoire, et donnent les mêmes nombres dans chaque copie jusqu’à ce qu’ils soient réensemencés ; de même pour les clés qu’un programme a générées avant la duplication. Rien ne signale à un processus qu’il a été copié : réensemencez après une duplication quand cela compte, ou demandez au noyau chaque valeur aléatoire (/dev/urandom, os.urandom, crypto/rand).

from pethost.sandboxes import Sandboxes, SandboxSettings, Size

sandboxes = Sandboxes()  # lit PETHOST_TOKEN
source = sandboxes.create_sandbox("base", settings=SandboxSettings(size=Size.SMALL))
sandboxes.run_command(source.sandbox_id, command="python3 -m venv env && env/bin/pip install numpy")

# Quatre copies de la source telle qu'elle est : son disque, sa mémoire et ses processus.
copies = sandboxes.fork_sandbox(source.sandbox_id, count=4).sandboxes
for seed, copy in enumerate(copies):
    command = f"env/bin/python -c 'import numpy; numpy.random.seed({seed}); print(numpy.random.rand())'"
    print(copy.sandbox_id, sandboxes.run_command(copy.sandbox_id, command=command).stdout)
id=$(pethost sandbox new --size small)
pethost sandbox run "$id" -- 'python3 -m venv env && env/bin/pip install numpy'
for copy in $(pethost sandbox fork "$id" --count 4); do
  pethost sandbox run "$copy" -- 'env/bin/python -c "import numpy; print(numpy.random.rand())"'
done

Limites et prix

Créer une copie ne coûte rien : chacune est un démarrage gratuit, et dès sa première seconde elle est facturée comme toute sandbox, à la seconde au prix de sa taille. Votre offre limite les démarrages par minute, par heure et par jour, 36, 360 et 1 200 avec l’offre à 20 $, et chaque copie compte pour un ; ses vCPU comptent aussi dans le budget de l’offre, 20 avec l’offre à 20 $, de quoi tenir une source SMALL et 9 copies SMALL. Une duplication de plus de copies que la limite d’une fenêtre est refusée d’emblée.

Une duplication est refusée tant que la source a un volume monté en lecture-écriture, et les copies restent toujours sur le serveur de la source. Pour un état dont vous repartez encore et encore, pendant des jours, sur n’importe quel serveur, enregistrez plutôt un template : il garde le disque, pas la mémoire.

Les exécutions courtes coûtent peu. Une évaluation de 1 000 sandboxes SMALL par jour, de 60 secondes chacune, représente 500 heures de sandbox, soit 9,00 $ de consommation par mois à 0,018 $ de l’heure, dans l’offre à 20 $ ; répartie sur la journée, cela fait environ 42 démarrages par heure, dans ses 360.

Face aux autres

D’après leurs pages au 21 novembre 2026 : E2B duplique aussi avec la mémoire. boat.dev duplique à partir du dernier snapshot du disque d’une sandbox et compte chaque duplication comme un démarrage, qui coûte de 0,03 à 0,07 $ au-delà des démarrages inclus dans son offre. La duplication de Vercel Sandbox copie le système de fichiers, et Daytona ne duplique que sa classe de VM Linux.

Lire la documentation

Questions

Puis-je dupliquer une sandbox active avec sa mémoire ?

Oui : une duplication copie la mémoire, les processus et le disque, à partir d’une source active ou en pause. Une sandbox arrêtée n’a pas de mémoire à copier : ses copies partent de son disque.

Les copies partagent-elles la mémoire de la source ?

Non. Chacune est une sandbox à part dès sa création : ce que l’une écrit, les autres ne le voient jamais.

Les nombres aléatoires se répètent-ils dans les copies ?

Ceux du noyau, non : il est réensemencé dans chaque copie. Les générateurs à l’intérieur des programmes sont copiés avec leur état, et se répètent jusqu’à ce qu’ils soient réensemencés.

Combien coûte une duplication ?

La créer ne coûte rien : chaque copie est un démarrage gratuit, dans la limite des démarrages par minute, par heure et par jour de votre offre. Chaque copie est ensuite facturée à la seconde, comme toute sandbox.

Des copies peuvent-elles atterrir sur un autre serveur ?

Non : elles sont créées sur le serveur de la source, toutes ou aucune.

Voir aussi

Donnez un ordinateur à votre agent en 0,15 s

Démarrer l’essai gratuit