🧩 Framework & Thư việnMã nguồn mởBeta

AgentENV

Nền tảng phân tán chạy môi trường agent bằng Firecracker microVM, hỗ trợ snapshot, fork sandbox và API tương thích E2B.

#agentenv
Danh mục
🧩 Framework & Thư viện
Giá
Mã nguồn mở
GitHub Stars
3,494
Ngôn ngữ
Rust
License
MIT
Ngày thêm
2026-08-05
Tóm tắt từ README GitHub
Running agent environments at scale 📖 Full documentation: Stable Dev AgentENV (AENV) is a platform for running agent environments at scale, powering agentic RL training for Kimi K3 . --- 🚀 Why AgentENV - Scale across diverse environments : AENV runs massive numbers of Firecracker environments across machines, loading diverse OCI-compatible images on demand via overlaybd and scaling to 1.5 million images in production. Local disk acts as a bounded cache, retaining hot data and evicting cold, so the aggregate image and snapshot footprint can exceed local disk capacity by several orders of magnitude while startup stays fast cluster-wide, without pre-warming every host. - Make idle environments inexpensive : Snapshot-backed environments boot or resume in under 50 ms and pause in under 100 ms. Idle environments can quickly release CPU and memory, then return when new work arrives. - Native snapshot and fork support : AENV snapshots memory and filesystem changes incrementally, completing in under 100 ms even under heavy disk modification. A running environment can fork into multiple independent sandboxes for parallel agent workflows. Snapshots persist to S3-compatible object s
Xem thêm từ README.md

Đánh giá chi tiết

Tổng quan

AgentENV, còn gọi là AENV, là lớp hạ tầng để chạy số lượng lớn môi trường cho AI agent. Thay vì để coding agent thực thi trực tiếp trên host hoặc khởi động container mới cho từng task, AENV dùng Firecracker microVM, image OCI và snapshot để tạo môi trường cô lập có thể pause, resume hoặc fork. Dự án cho biết nền tảng này đang phục vụ workload agentic reinforcement learning của Kimi K3.

Đây không phải một agent mới và cũng không phải UI trò chuyện. Giá trị của AgentENV nằm ở execution layer: cung cấp nơi để agent chạy shell, sửa file và dùng tool với vòng đời rõ ràng, sau đó nhân bản trạng thái cho nhiều nhánh thử nghiệm. API tương thích E2B giúp ứng dụng đang dùng E2B SDK có đường chuyển sang hạ tầng tự host.

Tính năng chính

  • Firecracker microVM và quyền truy cập KVM để cô lập workload.
  • Snapshot memory và filesystem, lưu lên S3-compatible storage hoặc distributed filesystem.
  • Fork một sandbox đang chạy thành nhiều môi trường độc lập.
  • Nạp OCI image theo nhu cầu bằng OverlayBD, dùng local disk như cache có giới hạn.
  • CLI aenv cho template, sandbox, shell, exec, TTL và xóa môi trường.
  • API tương thích E2B cho Python và TypeScript SDK.
  • Hướng dẫn single-node, Docker Compose và Kubernetes.

Điểm mạnh

Thiết kế snapshot/fork phù hợp với agent dài hơi và agentic RL, nơi cùng một trạng thái cần tách thành nhiều trajectory. Release v0.1.1 không chỉ thêm tính năng mà sửa các lỗi khá thực tế: short read của OverlayBD, kết nối sandbox qua nhiều runtime generation, resume sau pause failure và validation Dockerfile. Repository có 16 contributors hiển thị, tài liệu stable/dev, integration workflow xanh trên exact commit đã kiểm tra.

Hạn chế và an toàn

Cảnh báo lớn nhất được chính README nêu rõ: Authorization ở commit được kiểm tra chỉ xác nhận header token không rỗng, chưa xác minh token với identity hoặc policy thực. Vì vậy lớp này không đủ để bảo vệ API khi phơi ra public network; triển khai phải đặt sau auth proxy và network policy đáng tin cậy. Đây là khoảng trống nghiêm trọng vì API có khả năng tạo sandbox, chạy lệnh và truyền file.

Yêu cầu hệ thống cũng cao: privileged Linux, kernel 6.8+, KVM/ublk, installer tập trung Ubuntu 24.04 và kiến thức vận hành storage/network. Người dùng macOS có thể cài CLI, nhưng server execution vẫn là câu chuyện Linux. Lần chạy độc lập cargo test --workspace chưa khởi động được test vì host dùng rustc 1.86, trong khi dependency đã yêu cầu nhiều mức từ 1.88 đến 1.91; riêng nhóm iroh yêu cầu rustc 1.91. rust-toolchain.toml chỉ theo dõi kênh stable thay vì pin phiên bản, nên người build source phải dùng stable đủ mới và kiểm tra lại lockfile/toolchain. Đây là lỗi tương thích toolchain trước lúc compile, không phải test runtime thất bại. Các con số boot/resume dưới 100 ms là claim và benchmark của dự án; bài kiểm tra này chưa dựng cluster nhiều node hoặc xác minh hiệu năng với image lớn.

Phù hợp khi nào

AgentENV đáng xem với đội xây coding-agent platform, lab agentic RL hoặc dịch vụ cần hàng nghìn sandbox có snapshot. Nó không phù hợp cho người chỉ muốn chạy một agent cục bộ. Trước production cần bổ sung authentication, TLS, quota, audit, egress policy và một bài kiểm tra escape/isolation riêng; không nên xem microVM tự động giải quyết mọi vấn đề secrets hoặc dữ liệu.

AgentENV | Atlas for AI