Paddock: sandbox de agentes de IA hospedado por você

Para que serve o Paddock, em termos simples?

O Paddock entrega a um agente de IA um computador Linux separado em um VPS que você controla. Cada box reúne arquivos, ferramentas e um desktop Ubuntu XFCE. O agente pode executar comandos, construir um aplicativo e abri-lo para verificar o resultado. Você decide se mantém esse ambiente para continuar o trabalho ou o descarta ao terminar uma tarefa.

O site apresenta um projeto que precisa ser instalado. Visitar a página pública não fornece automaticamente uma máquina hospedada. O Paddock organiza a execução; o agente escolhido e seu modelo realizam o trabalho solicitado.

Executar testes e conferir uma aplicação real

As boxes executam Docker por meio do Sysbox. Claude Code, Codex, OpenCode, Pi, Prime e Kimi vêm instalados, mas a autenticação do serviço escolhido deve ser configurada. Envie uma tarefa com paddock prompt ou use comandos da CLI. Também há painel web, API HTTP e SDKs para TypeScript e Python.

Abra o desktop com paddock desktop, inicie um aplicativo gráfico usando exec --desktop e capture a tela com paddock screenshot. Isso permite inspecionar a interface que o agente realmente construiu e abriu.

Instalar e rodar o primeiro projeto

O guia de instalação exige um VPS Ubuntu ou Debian, acesso root, amd64 ou arm64, portas 80 e 443 abertas e um hostname apontando para o servidor. Após a instalação, use o link único de configuração para criar a conta proprietária. Instale a CLI no seu computador e faça login no servidor.

Para um projeto Node preparado, este fluxo copia os arquivos e roda os testes:

paddock new --type small --ttl 3600
paddock push current . --to /config/project
paddock exec current -- bash -lc 'cd /config/project && npm test'
paddock stop current

Confira a saída dos testes. As dependências precisam estar disponíveis ou ser instaladas com acesso de rede permitido. O comando final interrompe a box após salvar um snapshot do sistema de arquivos. Baixe os resultados com pull antes de excluir uma box temporária. O skill do Paddock permite que agentes compatíveis operem a CLI.

Persistência sem confundir snapshot com máquina congelada

Você pode parar, retomar, criar um fork e restaurar boxes. Os drives nomeados em /mnt preservam dados mesmo quando a box é excluída, o que ajuda a reutilizar caches e arquivos de entrada.

Os snapshots guardam o sistema de arquivos, mas não incluem RAM, processos em execução, /var/lib/docker ou dados dos drives montados. Planeje o backup desses drives separadamente. Retomar uma box não significa continuar um processo exatamente do ponto em que ele estava.

Restringir a rede e acompanhar para onde os dados vão

Há três opções: allow-all, deny-all e lista de domínios ou faixas IPv4 permitidos. O padrão inicial é allow-all. Deny-all impede novas conexões de saída, embora as já abertas possam terminar. O acesso a metadados da nuvem fica bloqueado em todos os modos.

Uma lista restrita precisa permitir APIs de modelos, repositórios e registros de pacotes essenciais. Hospedar o ambiente no seu VPS não altera as políticas dos provedores externos aos quais você envia dados. Essas regras não devem ser entendidas como garantia absoluta contra qualquer fuga do sandbox.

Código aberto e custos de operação

Verificado em 29 de outubro de 2026: o projeto utiliza a licença MIT. Os materiais oficiais consultados não apresentam assinatura de uma versão hospedada do Paddock. VPS, armazenamento e consumo de modelos podem ser cobrados por serviços separados. Não há um valor mensal único aplicável a todas as instalações.

É indicado para desenvolvedores que querem controlar o ambiente dos agentes e conseguem cuidar de Linux, atualizações, acessos e backups. A quantidade de boxes simultâneas depende dos recursos disponíveis.

Perguntas frequentes

O Paddock é gratuito?

O software MIT está disponível sem assinatura de software nas fontes verificadas. Isso não inclui gratuitamente hospedagem nem serviços de IA.

Posso usar Windows ou macOS?

Sim, há instruções de instalação da CLI para os dois. O servidor continua exigindo a infraestrutura Linux documentada.

Toda box começa sem internet?

Não. O padrão é allow-all. Configure deny-all ou uma lista permitida de acordo com a tarefa.

Recursos oficiais

• Repositório do projeto: código e referência técnica.
• Versões e downloads: binários disponíveis e informações das versões.