Deutsch
Loslegen

Agent Sandboxes Fork samt RAM

Eine laufende Sandbox forken, samt RAM

Bereite eine Umgebung einmal vor, ein Repository geklont, seine Abhängigkeiten installiert, ein Server gestartet, ein Agent mitten in einer Aufgabe, dann kopier sie ganz, mit RAM und Prozessen, und probier von genau diesem Punkt aus viele Dinge.

Was ein Fork ist

fork_sandbox kopiert eine Sandbox, wie sie gerade ist, mit RAM, Prozessen und Disk, in einem Aufruf in neue laufende Sandboxes, so viele, wie ihr Server Platz hat, höchstens 100. Jede Kopie macht ab dem Moment des Forks für sich weiter: dieselben Dateien, dieselben Programme im selben Zustand, eine Python-Sitzung mit ihren Variablen, ein Server mit offenem Port. Auch Agenten werden kopiert: Die Unterhaltung eines Coding-Agenten liegt auf der Disk der Sandbox, also kann jede Kopie dort weiter Prompts bekommen, wo die Quelle war.

Genau das brauchen RL- und Eval-Läufe: ein vorbereiteter Zustand, viele Versuche davon aus, und keiner zahlt noch einmal für das Klonen, die Installation oder die ersten Schritte der Aufgabe.

Wie das Forken einer Sandbox funktioniert

Die Kopien entstehen auf dem Server der Quelle. Eine laufende Quelle wird kopiert, während sie läuft, pausiert dann für ein paar Millisekunden, während ihr RAM festgehalten wird, und läuft weiter: 18 bis 56 ms bei einer Quelle mit stark fragmentierter Disk. Eine pausierte Quelle bleibt pausiert, und die Kopien einer gestoppten starten von ihrer Disk. Jede Kopie wird aus Reflinks dieses Abbilds wiederhergestellt und schreibt ab dann ihren eigenen RAM und ihre eigene Disk. Gemessen: eine Kopie in 258 ms über die API, drei in 247 ms auf dem Server.

Ein Fork gilt ganz oder gar nicht. Hat der Server nicht für jede Kopie Platz, entsteht keine, und der Aufruf sagt, wie viele passen würden (NoCapacity), sodass du genau so viele noch einmal anfragen kannst. Die Kopien haben die Größe der Quelle, mit ihrer Disk; du kannst ihnen eigene Labels und andere Einstellungsgruppen geben: Egress, Ports, Umgebung, Leerlauf-Timer.

Was jede Kopie neu bekommt und was sie behält

Jede Kopie hat eine eigene ID, ihre ID als Hostname, eine eigene machine-id und eigene Zufallszahlen des Kernels: Der Kernel wird beim Wiederherstellen neu gesetzt. Zufallsgeneratoren in Programmen sind eine andere Sache. Die von OpenSSL, Math.random von V8, random von Python und math/rand von Go wurden mit dem RAM kopiert und liefern in jeder Kopie dieselben Zahlen, bis sie neu gesetzt werden; ebenso Schlüssel, die ein Programm vor dem Fork erzeugt hat. Nichts sagt einem Prozess, dass er kopiert wurde, also setz die Generatoren nach einem Fork neu, wenn es darauf ankommt, oder hol jeden Zufallswert vom Kernel (/dev/urandom, os.urandom, crypto/rand).

from pethost.sandboxes import Sandboxes, SandboxSettings, Size

sandboxes = Sandboxes()  # liest 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")

# Vier Kopien der Quelle, wie sie gerade ist: Disk, RAM und Prozesse.
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

Grenzen und Preise

Eine Kopie zu erstellen kostet nichts: Jede ist ein kostenloser Start, und ab ihrer ersten Sekunde wird sie wie jede Sandbox abgerechnet, sekundengenau zum Preis ihrer Größe. Dein Tarif begrenzt die Starts pro Minute, Stunde und Tag, 36, 360 und 1.200 im Tarif für 20 $, und jede Kopie zählt als einer; ihre vCPUs zählen auch gegen das Budget des Tarifs, 20 im Tarif für 20 $, das reicht für eine SMALL-Quelle und 9 SMALL-Kopien. Ein Fork mit mehr Kopien, als ein Zeitfenster erlaubt, wird sofort abgelehnt.

Ein Fork wird abgelehnt, solange die Quelle ein Volume mit Schreibzugriff gemountet hat, und die Kopien bleiben immer auf dem Server der Quelle. Für einen Zustand, von dem du immer wieder startest, über Tage, auf jedem Server, speichere stattdessen eine Vorlage: Sie behält die Disk, nicht den RAM.

Kurze Läufe kosten wenig. Ein Eval mit 1.000 SMALL-Sandboxes am Tag, je 60 s, sind 500 Sandbox-Stunden, 9,00 $ Verbrauch im Monat zu 0,018 $ pro Stunde, innerhalb des Tarifs für 20 $; über den Tag verteilt sind das etwa 42 Starts pro Stunde, innerhalb seiner 360.

Im Vergleich

So stand es am 21. November 2026 auf ihren Seiten: E2B forkt ebenfalls mit RAM. boat.dev forkt vom letzten Disk-Snapshot einer Sandbox und zählt jeden Fork als Start, der über die enthaltenen Starts des Tarifs hinaus 0,03 bis 0,07 $ kostet. Der Fork von Vercel Sandbox kopiert das Dateisystem, und Daytona forkt nur seine Linux-VM-Klasse.

Doku lesen

Fragen

Kann ich eine laufende Sandbox mit ihrem RAM forken?

Ja: Ein Fork kopiert RAM, Prozesse und Disk, von einer laufenden oder pausierten Quelle. Eine gestoppte Sandbox hat keinen RAM zum Kopieren, also starten ihre Kopien von ihrer Disk.

Teilen sich die Kopien den RAM mit der Quelle?

Nein. Jede ist ab ihrer Erstellung eine eigene Sandbox: Was eine schreibt, sehen die anderen nie.

Wiederholen sich Zufallszahlen in den Kopien?

Die des Kernels nicht: Er wird in jeder Kopie neu gesetzt. Generatoren in Programmen werden mit ihrem Zustand kopiert und wiederholen sich, bis sie neu gesetzt werden.

Was kostet ein Fork?

Ihn zu erstellen kostet nichts: Jede Kopie ist ein kostenloser Start, innerhalb der Starts deines Tarifs pro Minute, Stunde und Tag. Danach wird jede Kopie sekundengenau abgerechnet, wie jede Sandbox.

Können Kopien auf einem anderen Server landen?

Nein: Sie entstehen auf dem Server der Quelle, alle oder keine.

Verwandte Funktionen

Gib deinem Agenten einen Computer in 0,15 s

Kostenlose Testphase starten