How scaleapi/agentenv-framework works
AgentEnv Framework is a Python SDK and CLI for defining, packaging, deploying, and running agent environments and graded tasks. The documented workflow starts with a user invoking the CLI, builds environments into versioned artifacts, deploys them behind a gateway, connects an agent, and evaluates its activity. The repository also provides protocol SDKs, extensible registries, persistence, and a local Explorer control plane. The workflow and capability links below rely on the README; source-level links are limited to relationships visible in the supplied excerpts or SOURCE INDEX, so some links are dashed where implementation was not sampled.
Main entry points: __main__.py CLI · env.py Environment model · task.py Task definitions · app.py Explorer API
Components 21
Authoring and configuration
- CLI
src/agent_env/cli/__main__.py - Configuration
src/agent_env/config/loader.py - Plugin registries
src/agent_env/plugins/_registration.py - Artifact registry
src/agent_env/artifact/registry.py - Bundle lifecycle
src/agent_env/bundle
Environment and agent runtime
- Environment model
src/agent_env/env/env.py - Deployment providers
src/agent_env/providers/env_providers/env_provider.py - Environment gateway
src/agent_env/env/gateway/gateway.py - Environment protocol client
packages/agentenv-protocol/src/agentenv_protocol/client.py - Protocol server SDK
packages/agentenv-protocol/src/agentenv_protocol/agent_env_environment.py - A2A agent support
packages/agentenv-protocol/src/agentenv_protocol/a2a_agent
Tasks and evaluation
- Task definitions
src/agent_env/task/task.py - Task steps
src/agent_env/task_step/task_step.py - Task runner
src/agent_env/runner/runner.py - Evaluation
src/agent_env/eval/eval.py
Control plane and persistence
- Explorer API
src/agent_env/explorer/app.py - Explorer UI
src/agent_env/explorer/ui/src/pages/[[...slug]].tsx - Store routing
src/agent_env/store/routing.py - Document persistence
src/agent_env/store/document_store/document_store.py - Object transfer
src/agent_env/store/object_store/object_store.py
Other components
- Developer / operator
Connections 21
- Developer / operator → CLI: invokes
README.md - CLI → Configuration: loads config
- Configuration → Plugin registries: builds registries
README.md - CLI → Bundle lifecycle: authors and runs
README.md - Bundle lifecycle → Artifact registry: materializes artifacts
README.md - CLI → Environment model: deploys environment
README.md - Environment model → Deployment providers: uses provider
src/agent_env/env/env.py - Environment model → Environment protocol client: calls protocol
src/agent_env/env/env.py - Deployment providers → Environment gateway: deploys behind
README.md - Protocol server SDK → Environment protocol client: serves protocol
- A2A agent support → Environment protocol client: communicates via
- CLI → Task definitions: runs tasks
README.md - Task definitions → Task steps: defines steps
- Task definitions → Task runner: executes through
README.md - Task runner → Evaluation: scores activity
README.md - CLI → Explorer API: starts control plane
README.md - Explorer API → Explorer UI: serves interface
src/agent_env/explorer/app.py - Explorer API → Store routing: configures stores
src/agent_env/explorer/app.py - Store routing → Document persistence: routes document access
src/agent_env/store/routing.py - Store routing → Object transfer: routes object access
src/agent_env/store/routing.py - Environment model → Bundle lifecycle: uses authoring support
src/agent_env/env/env.py