O que é um fork
fork_sandbox copia um sandbox como ele está agora, com memória, processos e disco, para novos sandboxes rodando em uma chamada, quantos o servidor dele comportar e no máximo 100. Cada cópia segue sozinha a partir do momento do fork: os mesmos arquivos, os mesmos programas no mesmo estado, uma sessão Python com as variáveis, um servidor com a porta aberta. Os agentes também são copiados: a conversa de um agente de código fica no disco do sandbox, então cada cópia pode receber prompts a partir de onde a origem estava.
É disso que execuções de RL e de evals precisam: um estado preparado, muitas tentativas a partir dele, e nenhuma pagando de novo pelo clone, pela instalação ou pelos primeiros passos da tarefa.
Como funciona o fork de um sandbox
As cópias são feitas no servidor da origem. Uma origem rodando é copiada enquanto roda, depois pausa por alguns milissegundos enquanto a memória é capturada, e segue: de 18 a 56 ms, medidos com uma origem de disco muito fragmentado. Uma origem pausada continua pausada, e as cópias de uma parada iniciam a partir do disco dela. Cada cópia é restaurada de reflinks dessa captura e, daí em diante, escreve a própria memória e o próprio disco. Medido: uma cópia em 258 ms pela API, três em 247 ms no servidor.
Um fork é tudo ou nada. Quando o servidor não tem espaço para todas as cópias, nada é criado e a chamada diz quantas caberiam (NoCapacity), para você pedir de novo essa quantidade. As cópias têm o tamanho da origem, com o disco dela; você pode dar a elas labels próprias e outros grupos de configurações: saída, portas, ambiente, timers de ociosidade.
O que cada cópia ganha de novo, e o que mantém
Cada cópia tem o próprio id, o id como hostname, o próprio machine-id e aleatoriedade própria do kernel: o kernel recebe uma nova semente na restauração. Geradores aleatórios dentro de programas são outra história. O do OpenSSL, o Math.random do V8, o random do Python e o math/rand do Go foram copiados com a memória e dão os mesmos números em todas as cópias até receberem uma nova semente; o mesmo vale para chaves que um programa criou antes do fork. Nada avisa a um processo que ele foi copiado, então troque a semente depois de um fork quando isso importar, ou peça ao kernel cada valor aleatório (/dev/urandom, os.urandom, crypto/rand).
from pethost.sandboxes import Sandboxes, SandboxSettings, Size
sandboxes = Sandboxes() # lê o 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")
# Quatro cópias da origem como está agora: disco, memória e processos.
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())"'
doneLimites e preços
Criar uma cópia não custa nada: cada uma é um início grátis e, a partir do primeiro segundo, é cobrada como qualquer sandbox, por segundo pelo preço do tamanho. Seu plano limita os inícios por minuto, hora e dia, 36, 360 e 1.200 no plano de US$ 20, e cada cópia conta como um; as vCPUs dela também contam no limite do plano, 20 no plano de US$ 20, o que comporta uma origem SMALL e 9 cópias SMALL. Um fork de mais cópias do que o limite de uma janela é recusado de cara.
Um fork é recusado enquanto a origem tem um volume de leitura e escrita montado, e as cópias sempre ficam no servidor da origem. Para um estado do qual você parte de novo e de novo, por dias, em qualquer servidor, salve um template: ele guarda o disco, não a memória.
Execuções curtas custam pouco. Uma eval de 1.000 sandboxes SMALL por dia, 60 segundos cada, dá 500 horas de sandbox, US$ 9,00 de uso por mês a US$ 0,018 por hora, dentro do plano de US$ 20; espalhadas ao longo do dia, são cerca de 42 inícios por hora, dentro dos 360.
Como se compara
Como as páginas deles diziam em 21 de novembro de 2026: o E2B também faz fork com memória. O boat.dev faz fork a partir do último snapshot de disco de um sandbox e conta cada fork como um início, que custa de US$ 0,03 a US$ 0,07 além dos inícios que o plano inclui. O fork do Vercel Sandbox copia o sistema de arquivos, e o Daytona só faz fork da classe de VM Linux dele.