Português
Começar

Agent Sandboxes Uma microVM por sandbox

Uma microVM Firecracker para cada sandbox

Um sandbox do Pethost é uma VM Linux, não um container: uma microVM Firecracker com kernel próprio, root lá dentro e rede própria. Ele inicia em cerca de 0,15 s porque é restaurado de um snapshot, em vez de dar boot.

O que é um sandbox

Cada sandbox roda em uma microVM Firecracker própria (Firecracker 1.18, no jailer dele), e o guest roda o próprio kernel Linux, 6.18. Ele inicia a partir do nosso template, base: Ubuntu 24.04 com ferramentas de build, git, Python 3, Node.js 22, Docker, Claude Code, Codex e OpenCode, e um desktop com Chrome. Lá dentro você é root: um comando roda como user, que tem sudo sem senha, ou como root quando você pede.

Um agente pode instalar pacotes, iniciar serviços, mudar arquivos do sistema ou rodar containers dentro da VM dele, e o que ele muda fica naquele sandbox: no disco dele, sob o kernel dele.

Como uma microVM Firecracker mantém um sandbox separado

Cada VM roda no jailer do Firecracker: um chroot próprio, um usuário sem privilégios para cada slot de rede, um cgroup, um filtro seccomp e um namespace de rede próprio, com regras contra endereços forjados. O guest só chega à rede pelo proxy e pelo resolver do servidor: TCP e DNS saem, UDP e ping não, e a lista de permissões de saída diz para onde o TCP pode ir.

Uma VM tem um só tamanho a vida toda, com as vCPUs e a memória desse tamanho, impostas pelo servidor e nunca pela palavra do guest: a cota do cgroup é o tempo que as vCPUs dela valem, escrita antes de a primeira thread rodar.

Os servidores também separam as VMs abaixo do guest. A virtualização aninhada está desativada, então nenhum guest roda um hypervisor próprio. Em processadores que vazam dados entre as duas threads de um núcleo, o SMT está desativado. O io_uring está desativado no servidor, e o que uma VM guarda nunca vai para swap em disco. Os tokens de API ficam no painel, e os segredos nunca entram em uma VM: um servidor vê tokens de conexão, cada um para um sandbox daquele servidor, com prazo de validade e revogáveis.

Por que ele inicia em 0,15 s

Um sandbox nunca dá boot. Cada servidor guarda um snapshot da nossa base em cada tamanho, e todo sandbox novo é uma restauração dele: o disco anexado, as vCPUs liberadas para rodar e o guest informado de quem ele é. O servidor mistura 64 bytes aleatórios no pool do kernel e o VMGenID do Firecracker renova a semente dele, então cada sandbox tem aleatoriedade própria, o próprio machine-id e o id como hostname.

O sistema de arquivos raiz é a nossa base, somente leitura e mapeada direto do page cache do servidor (DAX): software instalado na base e nunca rodado não custa memória ao sandbox, e o desktop e o Docker só iniciam quando algo pede por eles.

Medido por um painel de teste a 16 ms do servidor, uma criação levou 123 ms na mediana para SMALL e 158 ms para XLARGE, e o primeiro comando respondeu de 29 a 48 ms depois.

from pethost.sandboxes import Sandboxes, SandboxSettings, Size

sandboxes = Sandboxes()  # lê o PETHOST_TOKEN
sandbox = sandboxes.create_sandbox("base", settings=SandboxSettings(size=Size.SMALL))

# O kernel próprio, o id como hostname, as vCPUs do tamanho e root pelo sudo.
command = sandboxes.run_command(sandbox.sandbox_id, command="uname -r; hostname; nproc; sudo whoami")
print(command.stdout)
id=$(pethost sandbox new --size small)
pethost sandbox run "$id" -- 'uname -r; hostname; nproc; sudo whoami'

Tamanhos e preços

Quatro tamanhos, cada um com 2 GiB de memória e 5 GiB de disco por vCPU, cobrados por segundo enquanto rodam:

TamanhovCPUsMemóriaDiscoRodando, por hora
SMALL24 GiB10 GiBUS$ 0,018
DEFAULT48 GiB20 GiBUS$ 0,036
LARGE816 GiB40 GiBUS$ 0,072
XLARGE1632 GiB80 GiBUS$ 0,144

O disco é o que o sandbox pode escrever; os arquivos da própria base não contam. O plano de US$ 20 cria sandboxes até LARGE, os planos maiores até XLARGE, e o teste grátis até DEFAULT.

Limites

Não há GPUs. Nenhuma VM roda dentro de um sandbox, já que a virtualização aninhada está desativada; containers rodam, com o Docker. Um sandbox mantém a base de que foi criado enquanto existir, o Chrome dela incluído: criamos uma base nova todo mês, e na hora para uma correção de segurança do Chrome, do kernel ou de um pacote, e os sandboxes criados depois iniciam a partir dela. Todos os limites estão na documentação.

Como se compara

Em 21 de novembro de 2026, o E2B e o Vercel Sandbox diziam usar o Firecracker também, e o boat.dev uma VM por sandbox. O Daytona roda containers por padrão, com uma classe de VM Linux, e o Modal roda os sandboxes dele no gVisor, com um runtime de VM como opção. Uma VM por sandbox é terreno comum; os fornecedores diferem no que um sandbox guarda quando pausa e no que custa uma hora, o que a comparação põe lado a lado.

Ler a documentação

Perguntas

Cada sandbox é uma microVM Firecracker ou um container?

Uma microVM Firecracker, uma por sandbox, com o próprio kernel Linux. Containers rodam dentro dela, com o Docker.

Dá para rodar o Docker dentro de um sandbox?

Sim. O daemon do Docker inicia na primeira conexão ao socket dele, então não custa nada até lá. As imagens e os containers ficam no disco do sandbox: parar o sandbox os mantém, e um template os leva junto. Pulls do Docker Hub tentam o mirror.gcr.io primeiro.

Dá para rodar uma VM dentro de um sandbox?

Não: a virtualização aninhada está desativada em todos os servidores.

Eu sou root?

Sim. Um comando roda como user, que tem sudo sem senha, ou como root quando a chamada pede.

O que vem no template base?

Ubuntu 24.04 com build-essential, git, curl, ripgrep e jq, Python 3 com pip e venv, Node.js 22, Docker com Compose e Buildx, Claude Code, Codex e OpenCode com os SDKs deles, e um desktop: Google Chrome em uma tela de 1280×800, que inicia no primeiro uso.

Relacionados

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

Começar o teste grátis