AIO Sandbox is a Python-based all-in-one Docker container that unifies browser, shell, file, MCP, and VSCode Server functionality for AI agents. It emphasizes a single environment with shared filesystem and multiple interfaces, with release history up to v1.11.0 and Docker deployment guidance.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
AIO Sandbox is an all-in-one agent sandbox environment that combines Browser, Shell, File, MCP operations, and VSCode Server in a single Docker container.
How it works
The project provides a unified environment where multiple interfaces (VNC browser, CDP, MCP, VSCode Server, Jupyter, Terminal) run in one container with a shared filesystem. It exposes API endpoints for sandbox info, shell/file/browser/Jupyter operations and MCP servers. It includes client libraries for Python and TypeScript/JavaScript to interact with the sandbox via base_url.
Getting started
Docker usage (from README examples)
docker run --security-opt seccomp=unconfined --rm -it \
-e SANDBOX_API_KEY=your-secret-key \
-p 127.0.0.1:8080:8080 ghcr.io/agent-infra/sandbox:latest
docker run --security-opt seccomp=unconfined --rm -it \
-e SANDBOX_API_KEY=your-secret-key \
-p 127.0.0.1:8080:8080 enterprise-public-cn-beijing.cr.volces.com/vefaas-public/all-in-one-sandbox:1.11.0
docker run --security-opt seccomp=unconfined --rm -it \
-p 127.0.0.1:8080:8080 ghcr.io/agent-infra/sandbox:1.11.0
Quick Start URLs after running
- Documentation: http://localhost:8080/v1/docs
- VNC Browser: http://localhost:8080/vnc/index.html?autoconnect=true
- VSCode Server: http://localhost:8080/code-server/
- MCP Services: http://localhost:8080/mcp
SDK Installation
pip install agent-sandbox
npm install @agent-infra/sandbox
go get github.com/agent-infra/sandbox-sdk-go
Basic usage (Python)
from agent_sandbox import Sandbox
client = Sandbox(base_url="http://localhost:8080")
home_dir = client.sandbox.get_context().home_dir
Basic usage (TypeScript)
import { Sandbox } from '@agent-infra/sandbox';
const sandbox = new Sandbox({ baseURL: 'http://localhost:8080' });
Recent releases
- v1.11.0 (2026-06-23): AIO Sandbox 1.11.0 adds browser file-picker policy controls, fuller Codex configuration support, MCP Bash output controls, and image build improvements.
- v1.10.0 (2026-06-15): AIO Sandbox 1.10.0 adds built-in OpenAI Codex CLI support and includes reliability improvements for Shell and Browser workflows. Codex CLI integration is noted.
- v1.9.3 (2026-05-29): Alignment to SemVer; cumulative release up to 1.9.3 and consolidation prior to 2.0 refactor.
- v1.0.0.152 (2025-11-12): Established the AIO Sandbox evaluation framework & dataset and generated evaluation reports.
- v1.0.0.151 (2025-11-07): Fixed homepage 404 issue after subpath deployment; added AIO_SKILLS_PATH env var for mounting Skills.
Traction
5557 stars, 497 forks, 81 open issues as of the facts.
Behind the repo
No linked startup/company information provided in the facts.
Caveats
License: Apache-2.0. Created: 2025-08-06. Last push: 2026-07-02. Language: Python. Docker/Deployment examples and environment variables are described in the README; no further age notes beyond release history are provided in the facts.