AgentENV

What it is

AgentENV (AENV) is a platform for running agent environments at scale, powering agentic RL training. It supports running many Firecracker environments across machines, with on-demand image loading via overlaybd and local disk as a bounded cache. Snapshots persist to S3-compatible object storage or a shared distributed filesystem, and environments can fork into multiple sandboxes.

How it works

• Runs Firecracker-based environments across machines with OCI-compatible images loaded on demand.
• Uses local disk as a bounded cache and overlaybd for on-demand image loading.
• Snapshots memory and filesystem changes incrementally; snapshots persist to S3-compatible object storage or a shared distributed filesystem.
• Forks allow a running environment to create multiple independent sandboxes.
• Memory and I/O are optimized with ublk and shared host page cache; memory ballooning reclaims guest memory.

Getting started

Prerequisites:

• Linux kernel 6.8+
• Ubuntu 24.04 (install script requires this)
• /dev/kvm access for Firecracker

Quick Start (Single Node):

1. Install and start the server Option A — install script (Ubuntu 24.04):

curl -fsSL https://raw.githubusercontent.com/kvcache-ai/AgentENV/main/scripts/install.sh | sudo bash
sudo systemctl start aenv

Option B — Docker:

curl -fsSL https://raw.githubusercontent.com/kvcache-ai/AgentENV/main/scripts/docker-setup.sh | sudo bash
docker pull ghcr.io/kvcache-ai/aenv-server:latest
docker run -d --privileged -v /dev:/dev -p 8000:8000 ghcr.io/kvcache-ai/aenv-server:latest

The server is accessible at http://127.0.0.1:8000

2. Install the aenv CLI (if not using Docker):

curl -fsSL https://raw.githubusercontent.com/kvcache-ai/AgentENV/main/scripts/install-cli.sh | bash

3. Authenticate:

aenv auth
# AENV server URL [http://localhost:8000]: http://127.0.0.1:8000
# API key: dummy

4. Pull a template and run a sandbox:

aenv pull ubuntu:22.04 --name ubuntu
aenv start ubuntu

Recent releases

• v0.1.0 v0.1.0 (2026-07-25): Initial open-source release of AgentENV

Traction

1398 stars total; gained 835 stars in the last 24h; 39 open issues

License

MIT

Getting started notes

• The Quick Start includes two install modes: a script-based install or Docker-based setup.
• The aenv CLI supports commands for templates and sandboxes, including pull, start, detach, and list operations.