Repolode
Enviar
agent-infra

agent-infra/sandbox

Sandbox Docker completo que oferece a agentes de IA um navegador, shell, sistema de arquivos, VSCode Server, Jupyter e serviços MCP compartilhados.

Ver no GitHubSite
Estrelas
6,185
Forks
561
Issues abertas
73
Último commit
mês passado

O que é?

O AIO Sandbox reúne navegador, terminal, sistema de arquivos, VSCode Server, Jupyter e serviços MCP em um único contêiner Docker. Agentes e desenvolvedores podem executar comandos no shell, ler e gravar arquivos, controlar um navegador e executar código Python ou Node.js no mesmo ambiente. Assim, os arquivos baixados pelo navegador ficam disponíveis imediatamente para operações no shell e no sistema de arquivos.

O acesso é feito por APIs HTTP, com SDKs oficiais para Python, TypeScript e Go. O contêiner disponibiliza uma área de trabalho VNC, o Chrome DevTools Protocol para controlar o navegador, uma IDE web do VSCode e servidores MCP pré-configurados para navegador, arquivos, shell e conversão de documentos. É possível proteger a API, o JupyterLab e os endpoints VNC com uma chave de API opcional.

O projeto oferece manifests para Docker Compose e Kubernetes e pode ser integrado a frameworks de agentes como browser-use e LangChain, ou a APIs de modelos compatíveis com OpenAI para chamadas de ferramentas.

Recursos principais

  • 01Controle do navegador por VNC, Chrome DevTools Protocol e ferramentas MCP
  • 02Terminal shell e operações de leitura e gravação de arquivos que compartilham o mesmo sistema de arquivos
  • 03VSCode Server e JupyterLab integrados para programar no navegador
  • 04Servidores MCP pré-configurados para navegador, arquivos, shell e conversão de documentos
  • 05Execução de código Python e Node.js dentro do sandbox
  • 06Autenticação opcional por chave de API para a API e os endpoints dos serviços

Casos de uso

  • Oferecer a um agente de IA um ambiente seguro para executar comandos no shell e código
  • Automatizar tarefas no navegador que exigem processar os arquivos baixados em seguida
  • Disponibilizar uma IDE na nuvem descartável para desenvolvedores, em um contêiner
  • Conectar frameworks de agentes, como browser-use ou LangChain, a um ambiente de ferramentas pronto para uso

Início rápido

  1. 1

    Execute o contêiner de sandbox com uma chave de API (recomendado)

    docker run --security-opt seccomp=unconfined --rm -it -e SANDBOX_API_KEY=your-secret-key -p 127.0.0.1:8080:8080 ghcr.io/agent-infra/sandbox:latest
  2. 2

    Abra a documentação em localhost:8080

  3. 3

    Instale o SDK do Python (opcional)

    pip install agent-sandbox

Antes de usar

  • Requer Docker, e o contêiner é executado com seccomp unconfined.
  • A configuração depende do download de uma imagem de contêiner completa e de grande porte.

Tópicos

#agent#sandbox#docker#mcp#browser-automation#code-execution#jupyter#vscode#all-in-one#browser

Perguntas frequentes

O que é sandbox?
Sandbox Docker completo que oferece a agentes de IA um navegador, shell, sistema de arquivos, VSCode Server, Jupyter e serviços MCP compartilhados. O AIO Sandbox reúne navegador, terminal, sistema de arquivos, VSCode Server, Jupyter e serviços MCP em um único contêiner Docker. Agentes e desenvolvedores podem executar comandos no shell, ler e gravar arquivos, controlar um navegador e executar código Python ou Node.js no mesmo ambiente. Assim, os arquivos baixados pelo navegador ficam disponíveis imediatamente para operações no shell e no sistema de arquivos.
sandbox é gratuito? Qual é a licença?
sandbox é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
sandbox ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de sandbox foi em 14 de set. de 2026.
Para que posso usar sandbox?
Oferecer a um agente de IA um ambiente seguro para executar comandos no shell e código Automatizar tarefas no navegador que exigem processar os arquivos baixados em seguida Disponibilizar uma IDE na nuvem descartável para desenvolvedores, em um contêiner Conectar frameworks de agentes, como browser-use ou LangChain, a um ambiente de ferramentas pronto para uso
Como instalar sandbox?
Execute o contêiner de sandbox com uma chave de API (recomendado): docker run --security-opt seccomp=unconfined --rm -it -e SANDBOX_API_KEY=your-secret-key -p 127.0.0.1:8080:8080 ghcr.io/agent-infra/sandbox:latest Abra a documentação em localhost:8080 Instale o SDK do Python (opcional): pip install agent-sandbox
Onde consigo sandbox?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/agent-infra/sandbox

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados