Repolode
opensandbox-group

opensandbox-group/OpenSandbox

Runtime de sandbox open source que oferece aos agentes de IA ambientes isolados para executar código, comandos, arquivos e navegadores na sua própria infraestrutura.

Estrelas
16,481
Forks
1,555
Issues abertas
158
Último commit
ontem

O que é?

OpenSandbox oferece ambientes de sandbox isolados para que aplicações de IA executem código, rodem comandos de shell, gerenciem arquivos e operem navegadores ou desktops. Ele roda localmente no Docker e pode ser implantado no Kubernetes, com ambos gerenciados por uma API de sandbox unificada.

O projeto inclui um runtime Fast Sandbox baseado em microVMs Firecracker, com suporte a pausa e retomada preservando o estado da memória e do disco. O acesso à rede é controlado por um gateway de entrada unificado e políticas de saída por sandbox, e um Credential Vault permite que agentes chamem serviços externos sem armazenar as credenciais reais.

O acesso para clientes está disponível por meio de SDKs para Python, Java/Kotlin, TypeScript/JavaScript, C#/.NET e Go, de uma CLI de terminal chamada osb e de um servidor MCP para clientes como Claude Code e Cursor. As integrações de exemplo abrangem agentes de programação, interpretadores de código, automação com Playwright e Chrome, ambientes de desktop e frameworks de avaliação de agentes.

Recursos principais

  • 01Cria sandboxes a partir de imagens de container com uma API unificada de ciclo de vida, localmente no Docker ou no Kubernetes.
  • 02Executa comandos, lê e grava arquivos e roda código em ambientes isolados.
  • 03O runtime Fast Sandbox baseado em Firecracker oferece suporte a pausa e retomada com preservação do estado.
  • 04Políticas de saída por sandbox e um gateway de entrada unificado controlam o acesso à rede.
  • 05O Credential Vault injeta credenciais em chamadas de saída sem expô-las às cargas de trabalho do sandbox.
  • 06SDKs para Python, Java/Kotlin, TypeScript, C#/.NET e Go, além da CLI osb e de um servidor MCP.

Casos de uso

  • Executar agentes de programação como Claude Code ou Codex CLI em ambientes isolados, onde podem editar arquivos e rodar comandos.
  • Executar código gerado por modelos e analisar resultados usando o Code Interpreter SDK.
  • Automatizar navegadores ou oferecer aos agentes um ambiente de desktop para testes na web.
  • Executar um sandbox separado para cada teste ao avaliar agentes ou treiná-los com aprendizado por reforço.

Início rápido

  1. 1

    Gere a configuração de exemplo do servidor (requer Docker)

    uvx opensandbox-server init-config ~/.sandbox.toml --example docker
  2. 2

    Inicie o servidor sandbox

    uvx opensandbox-server
  3. 3

    Instale o SDK do Python

    uv pip install opensandbox

Antes de usar

  • A execução local requer Docker, e a implantação em produção no Kubernetes requer um cluster e a configuração operacional necessária.

Em coleções

Tópicos

Perguntas frequentes

O que é OpenSandbox?
Runtime de sandbox open source que oferece aos agentes de IA ambientes isolados para executar código, comandos, arquivos e navegadores na sua própria infraestrutura. OpenSandbox oferece ambientes de sandbox isolados para que aplicações de IA executem código, rodem comandos de shell, gerenciem arquivos e operem navegadores ou desktops. Ele roda localmente no Docker e pode ser implantado no Kubernetes, com ambos gerenciados por uma API de sandbox unificada.
OpenSandbox é gratuito? Qual é a licença?
OpenSandbox é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
OpenSandbox ainda é mantido?
Manutenção ativa. O último commit de OpenSandbox foi em 6 de nov. de 2026.
Para que posso usar OpenSandbox?
Executar agentes de programação como Claude Code ou Codex CLI em ambientes isolados, onde podem editar arquivos e rodar comandos. Executar código gerado por modelos e analisar resultados usando o Code Interpreter SDK. Automatizar navegadores ou oferecer aos agentes um ambiente de desktop para testes na web. Executar um sandbox separado para cada teste ao avaliar agentes ou treiná-los com aprendizado por reforço.
Como instalar OpenSandbox?
Gere a configuração de exemplo do servidor (requer Docker): uvx opensandbox-server init-config ~/.sandbox.toml --example docker Inicie o servidor sandbox: uvx opensandbox-server Instale o SDK do Python: uv pip install opensandbox
Onde consigo OpenSandbox?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/opensandbox-group/OpenSandbox

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

Projetos relacionados