agentenv

O AgentENV (AENV) é uma plataforma distribuída projetada para executar ambientes de agentes em escala, notadamente alimentando o treinamento de RL agêntico para o Kimi K3. Ele permite a implantação massiva de microVMs Firecracker em várias máquinas, carregando diversas imagens compatíveis com OCI sob demanda via overlaybd. O sistema usa o disco local como um cache limitado, retendo dados quentes e descartando os frios, permitindo que as pegadas agregadas de imagens e snapshots excedam a capacidade do disco local em ordens de magnitude, mantendo inicialização rápida em todo o cluster sem pré-aquecer cada host. As principais capacidades incluem: - **Escala em ambientes diversos**: Executa um número massivo de ambientes Firecracker, escalando para 1,5 milhão de imagens em produção. - **Ambientes ociosos de baixo custo**: Ambientes respaldados por snapshots inicializam ou retomam em menos de 50 ms e pausam em menos de 100 ms, permitindo que ambientes ociosos liberem rapidamente CPU e memória. - **Suporte nativo a snapshots e forks**: Faz snapshots de mudanças de memória e sistema de arquivos de forma incremental em menos de 100 ms; ambientes em execução podem gerar forks em múltiplos sandboxes independentes para fluxos de trabalho de agentes paralelos. Snapshots persistem em armazenamento de objetos compatível com S3 ou sistemas de arquivos distribuídos compartilhados. - **Preservação de desempenho e densidade**: Oferece I/O de alto desempenho via ublk enquanto compartilha o page cache do host entre dados de armazenamento e de snapshots de memória. O memory ballooning devolve memória recuperável do guest ao host, alcançando uma taxa de overcommit de memória de 9,6x em produção. Pré-requisitos: kernel Linux 6.8+ e acesso a /dev/kvm para execução de microVMs Firecracker. Para servidores sem KVM padrão, um guia de implantação PVM está disponível. Início rápido (nó único) envolve instalar o servidor (via script de instalação ou Docker), instalar a CLI aenv, autenticar com a chave de API gerada, baixar um template (por exemplo, ubuntu:22.04) e iniciar um sandbox. A implantação suporta Docker Compose, clusters Kubernetes e build a partir do código-fonte. O AgentENV expõe uma API HTTP compatível com E2B, permitindo o uso dos SDKs padrão E2B Python/TypeScript sem alterações no código. A CLI aenv fornece comandos para gerenciamento de templates (pull, list), ciclo de vida de sandbox (start, pause, resume, delete, exec) e reanexação (cn). O projeto aceita contribuições via relatórios de bugs, propostas de recursos, correções de documentação e pull requests, seguindo as diretrizes de CONTRIBUTING.md e SECURITY.md.