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.
kubernetes-sigs/agent-sandbox
Um controller e uma CRD do Kubernetes para gerenciar sandboxes isoladas, com estado e em um único pod, voltadas a runtimes de agentes de IA e workloads de RL.
- Estrelas
- 4,534
- Forks
- 607
- Issues abertas
- 177
- Último commit
- ontem
O que é?
agent-sandbox adiciona ao Kubernetes um recurso customizado Sandbox e um controller para executar um workload de longa duração em um único container, com hostname estável, identidade de rede e armazenamento persistente opcional. O projeto preenche uma lacuna entre Deployments, que são stateless e replicados, e StatefulSets, que gerenciam conjuntos numerados de pods. O projeto é desenvolvido pela SIG Apps.
O módulo opcional de extensões adiciona SandboxTemplate, para definições reutilizáveis de sandbox; SandboxWarmPool, para manter sandboxes pré-aquecidas prontas para alocação; e SandboxClaim, para solicitar uma sandbox de um pool sem precisar gerenciar toda a configuração. Os pods de sandbox podem ser configurados para rodar com runtimes como gVisor ou Kata Containers por meio de RuntimeClass, deixando a orquestração a cargo do controller e o isolamento a cargo do runtime.
O projeto também oferece SDKs para Go e Python e o Sandbox Router, um proxy reverso HTTP que encaminha o tráfego dos clientes aos pods de sandbox. A instalação pode ser feita com manifests do kubectl ou Helm.
Recursos principais
- 01A CRD Sandbox fornece um pod com estado, hostname estável e identidade de rede.
- 02O armazenamento persistente pode sobreviver a reinicializações do pod.
- 03O gerenciamento do ciclo de vida inclui criação, exclusão programada, pausa e retomada.
- 04SandboxWarmPool mantém sandboxes pré-aquecidas prontas para alocação rápida.
- 05SandboxClaim solicita sandboxes de um pool sem gerenciar toda a configuração.
- 06Funciona com gVisor ou Kata Containers por meio de RuntimeClass.
- 07Há SDKs para Go e Python.
Casos de uso
- Executar código gerado por LLMs ou não confiável em ambientes isolados para agentes de IA.
- Disponibilizar sandboxes de inicialização rápida para loops de aprendizado por reforço e avaliação.
- Hospedar ambientes de desenvolvimento persistentes na nuvem ou sessões no estilo Jupyter.
- Executar serviços de instância única que precisam de uma identidade estável sem a sobrecarga de StatefulSet.
Início rápido
- 1
Instale o núcleo e as extensões com kubectl (versão mais recente)
kubectl apply -f https://github.com/kubernetes-sigs/agent-sandbox/releases/latest/download/sandbox-with-extensions.yaml - 2
Verifique se o CRD de Sandbox está instalado
kubectl get crd sandboxes.agents.x-k8s.io - 3
Aplique um manifesto de Sandbox com sua imagem de contêiner
Antes de usar
- Requer um cluster Kubernetes com o controlador agent-sandbox instalado.
- O isolamento do Sandbox depende de um runtime separado, como gVisor ou Kata Containers.
Em coleções
Tópicos
Perguntas frequentes
- O que é agent-sandbox?
- Um controller e uma CRD do Kubernetes para gerenciar sandboxes isoladas, com estado e em um único pod, voltadas a runtimes de agentes de IA e workloads de RL. agent-sandbox adiciona ao Kubernetes um recurso customizado Sandbox e um controller para executar um workload de longa duração em um único container, com hostname estável, identidade de rede e armazenamento persistente opcional. O projeto preenche uma lacuna entre Deployments, que são stateless e replicados, e StatefulSets, que gerenciam conjuntos numerados de pods. O projeto é desenvolvido pela SIG Apps.
- agent-sandbox é gratuito? Qual é a licença?
- agent-sandbox é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
- agent-sandbox ainda é mantido?
- Manutenção ativa. O último commit de agent-sandbox foi em 6 de nov. de 2026.
- Para que posso usar agent-sandbox?
- Executar código gerado por LLMs ou não confiável em ambientes isolados para agentes de IA. Disponibilizar sandboxes de inicialização rápida para loops de aprendizado por reforço e avaliação. Hospedar ambientes de desenvolvimento persistentes na nuvem ou sessões no estilo Jupyter. Executar serviços de instância única que precisam de uma identidade estável sem a sobrecarga de StatefulSet.
- Como instalar agent-sandbox?
- Instale o núcleo e as extensões com kubectl (versão mais recente): kubectl apply -f https://github.com/kubernetes-sigs/agent-sandbox/releases/latest/download/sandbox-with-extensions.yaml Verifique se o CRD de Sandbox está instalado: kubectl get crd sandboxes.agents.x-k8s.io Aplique um manifesto de Sandbox com sua imagem de contêiner
- Onde consigo agent-sandbox?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/kubernetes-sigs/agent-sandbox
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Um agente minimalista de engenharia de software com IA que resolve issues do GitHub ou ajuda pela linha de comando, usando apenas bash e cerca de 100 linhas de Python no núcleo.
Um coworker pessoal de IA self-hosted, com interface Web e baseado em um agente Claude Code, integração com apps de mensagens e execução de tarefas em sandbox.
Conjunto de bibliotecas Go para criar controllers e operators do Kubernetes, usado como base do Kubebuilder e do Operator SDK.
Runtime sandboxed de confiança zero no Kubernetes que distribui muitos agentes de IA com estado por um pequeno pool de workers, criando snapshots dos agentes ociosos.
Framework leve de RL agêntico da Microsoft para treinar agentes de IA existentes com reinforcement learning, mantendo suas ferramentas e seus harnesses reais.