Português
Começar

Agent Sandboxes Fork com memória e tudo

Faça fork de um sandbox rodando, com memória e tudo

Prepare um ambiente uma vez, com um repositório clonado, as dependências instaladas, um servidor no ar, um agente no meio de uma tarefa, depois copie-o inteiro, com memória e processos, e tente muitas coisas a partir desse mesmo ponto.

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())"'
done

Limites 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.

Ler a documentação

Perguntas

Dá para fazer fork de um sandbox rodando com a memória?

Sim: um fork copia memória, processos e disco, de uma origem rodando ou pausada. Um sandbox parado não tem memória para copiar, então as cópias dele iniciam a partir do disco.

As cópias compartilham memória com a origem?

Não. Cada uma é um sandbox próprio desde o momento em que é criada: o que uma escreve, as outras nunca veem.

Os números aleatórios se repetem nas cópias?

Os do kernel não: ele recebe uma nova semente em cada cópia. Os geradores dentro de programas são copiados com o estado e se repetem até receberem uma nova semente.

Quanto custa um fork?

Criá-lo não custa nada: cada cópia é um início grátis, dentro dos inícios por minuto, hora e dia do seu plano. Depois, cada cópia é cobrada por segundo, como qualquer sandbox.

As cópias podem ir para outro servidor?

Não: elas são criadas no servidor da origem, todas ou nenhuma.

Relacionados

Dê um computador ao seu agente em 0,15 s

Começar o teste grátis