Agentenv Framework

AgentEnv Framework is a Python SDK and CLI for building, deploying and running agentic environments and the tasks that grade agents inside them. Environments are containerized servers that speak the open agentenv-framework-protocol; AgentEnv Framework builds them into versioned images, deploys them behind a gateway, points an agent at them, and scores what the agent did.

Documentation: www.agentenvframework.com/docs covers environments, artifacts, agents, tasks, the registry and plugins.

Install

Both packages are on PyPI. You need Python 3.11.4 or newer and, to run environments locally, a running Docker daemon. With uv, install the agent-env command as a tool:

uv tool install agentenv-framework
agent-env run hello

agent-env run hello runs the built-in hello task, which needs no Docker, model or configuration. agent-env run echo-mcp needs Docker: it builds an MCP server from a Dockerfile, deploys it through the gateway and checks it by calling its tool. agent-env run lists both. To try hello without installing anything, run it with uvx:

uvx --from agentenv-framework agent-env run hello

Or install it with pip, into a virtualenv:

pip install agentenv-framework

To use the SDK in your own project, add it as a dependency with uv add agentenv-framework. The explorer, agent-env up, needs the explorer extra (uv tool install 'agentenv-framework[explorer]', or the same extra with uvx or pip) and an .agentenv/config.toml in the current folder or above it; an empty one keeps every local default. The tensorlake sandbox backend needs the tensorlake extra (pip install 'agentenv-framework[tensorlake]') and an api_key in [sandbox.providers.tensorlake.config]. Its sandboxes boot from the public image agentenv-dind-host-v1; set image there to use another registered Docker-capable image. The tenki sandbox backend needs the tenki extra (pip install 'agentenv-framework[tenki]') and an api_key in [sandbox.providers.tenki.config]; see its README.

A plain install runs on local stores and needs no cloud SDK. The cloud store backends are extras: aws for S3, Secrets Manager, DynamoDB and ECR (pip install 'agentenv-framework[aws]'), and gcp for Cloud Storage, Secret Manager, Firestore and Artifact Registry (pip install 'agentenv-framework[gcp]'). A config that names a backend without its extra fails, naming the extra to install.

The distribution is named agentenv-framework, the import package is agent_env and the command is agent-env. It depends on agentenv-framework-protocol, whose import package is agentenv_protocol, and installs it too.

Sandbox providers

For a complete evaluation using your existing Vercel login, follow the Vercel Sandbox demo.

The default provider runs environments and agents as containers on the local Docker daemon. The vercel provider runs each environment or agent in an ephemeral, Docker-capable Vercel Sandbox and exposes declared ports through public *.vercel.run routes. From this source checkout, install the optional extra and select it in .agentenv/config.toml. This provider is not yet in a published PyPI release:

uv sync --frozen --extra vercel