Repolode
Enviar
anthropics

anthropics/sandbox-runtime

CLI e biblioteca leves que restringem o acesso ao sistema de arquivos e à rede de processos arbitrários no nível do sistema operacional, sem contêineres.

Ver no GitHub
Estrelas
6,425
Forks
562
Issues abertas
300
Último commit
há 7 horas

O que é?

srt encapsula qualquer comando — como um agente de IA, um servidor MCP local, um comando bash ou outro processo — e limita o que ele pode ler, gravar e acessar pela rede. No macOS, usa sandbox-exec com perfis Seatbelt gerados; no Linux, usa bubblewrap com um namespace de rede. No Windows, executa o processo com uma conta local dedicada e uma barreira de saída da Windows Filtering Platform.

O acesso à rede é negado por padrão. O tráfego permitido passa por proxies HTTP e SOCKS5 no host, que aplicam listas de permissão e de bloqueio de domínios. As regras do sistema de arquivos seguem o modelo de negar e depois permitir para leituras, e de permitir somente o que estiver explicitamente autorizado para gravações. O acesso a sockets Unix é bloqueado por padrão em ambas as plataformas.

O pacote pode ser usado pela linha de comando como `srt` ou importado como biblioteca TypeScript com SandboxManager. Também oferece um arquivo de configurações, relatórios de violações no macOS e um canal de configuração em tempo de execução.

Recursos principais

  • 01Restringe leituras e gravações no sistema de arquivos para qualquer árvore de processos
  • 02Aplica listas de permissão e de bloqueio de domínios por meio de proxies no host
  • 03Usa sandbox-exec no macOS e bubblewrap no Linux
  • 04Bloqueia o acesso a sockets Unix por padrão
  • 05Oferece uma CLI e uma API de biblioteca TypeScript

Casos de uso

  • Isolar agentes de programação com IA para impedir que leiam chaves SSH ou acessem hosts arbitrários
  • Restringir servidores MCP locais a diretórios e destinos de rede específicos
  • Executar comandos bash ou scripts de build não confiáveis com acesso limitado

Início rápido

  1. 1

    Instale o pacote globalmente com npm

    npm install -g @anthropic-ai/sandbox-runtime
  2. 2

    Execute um comando dentro do sandbox

    srt "curl example.com"

Antes de usar

  • É uma versão prévia de pesquisa em beta; as APIs e os formatos de configuração podem mudar.
  • Depende de primitivas do sistema operacional, como sandbox-exec no macOS e bubblewrap no Linux. No Linux, é necessário instalar o bubblewrap.
  • O suporte ao Windows tem limitações conhecidas e documentadas relacionadas a tokens de processo e serviços do sistema.

Em coleções

Servidores MCPFerramentas de varredura, auditoria e inteligência de ameaças

Tópicos

#sandbox#security#agent-safety#network-isolation#filesystem#bubblewrap#seatbelt#mcp

Perguntas frequentes

O que é sandbox-runtime?
CLI e biblioteca leves que restringem o acesso ao sistema de arquivos e à rede de processos arbitrários no nível do sistema operacional, sem contêineres. srt encapsula qualquer comando — como um agente de IA, um servidor MCP local, um comando bash ou outro processo — e limita o que ele pode ler, gravar e acessar pela rede. No macOS, usa sandbox-exec com perfis Seatbelt gerados; no Linux, usa bubblewrap com um namespace de rede. No Windows, executa o processo com uma conta local dedicada e uma barreira de saída da Windows Filtering Platform.
sandbox-runtime é gratuito? Qual é a licença?
sandbox-runtime é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
sandbox-runtime ainda é mantido?
Manutenção ativa. O último commit de sandbox-runtime foi em 24 de out. de 2026.
Para que posso usar sandbox-runtime?
Isolar agentes de programação com IA para impedir que leiam chaves SSH ou acessem hosts arbitrários Restringir servidores MCP locais a diretórios e destinos de rede específicos Executar comandos bash ou scripts de build não confiáveis com acesso limitado
Como instalar sandbox-runtime?
Instale o pacote globalmente com npm: npm install -g @anthropic-ai/sandbox-runtime Execute um comando dentro do sandbox: srt "curl example.com"
Onde consigo sandbox-runtime?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/anthropics/sandbox-runtime

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

Projetos relacionados