sandbox-doc

---
name: sandbox-doc
description: Documentation for AIO Sandbox (agent-infra/sandbox) — all-in-one agent sandbox combining Browser, Shell, File, MCP, VSCode Server, and Jupyter in a single Docker container. Use when working with sandbox environments, agent execution environments, browser automation in containers, or MCP tool integration.
license: Apache-2.0
---

# AIO Sandbox Documentation

All-in-one sandbox environment for AI agents — combines Browser, Shell, File, MCP, VSCode Server, and Jupyter in a single Docker container.

**Repository:** [agent-infra/sandbox](https://github.com/agent-infra/sandbox) · **Website:** [sandbox.agent-infra.com](https://sandbox.agent-infra.com) · **License:** Apache 2.0

## Authority

- Files under `references/codebase/` are official project documentation. Authoritative. Always prefer these.
- Files under `references/supplements/` are LLM-generated supplementary documentation. Not authoritative. Use as a starting point; verify against `references/codebase/` or source code.

## Semantic Router

| Trigger | Action |
|---|---|
| Getting started, introduction, what is AIO Sandbox, architecture overview, background, use cases | Load and read `references/codebase/website/docs/en/guide/start/introduction.md` |
| Quick start, getting up and running, docker run, installation, prerequisites, first steps | Load and read `references/codebase/website/docs/en/guide/start/quick-start.mdx` |
| FAQ, frequently asked questions, troubleshooting, common issues | Load and read `references/codebase/website/docs/en/guide/start/faq.md` |
| agent call sandbox vs in sandbox, agent placement, where to run agent | Load and read `references/codebase/website/docs/en/guide/start/agent-sandbox.md` |
| Basic guide navigation — sandbox context, browser, shell, bash, file, code, Jupyter, Node.js, MCP, skills, auth, error handling | Load and read `references/routers/basic-guide-router.md` |
| Advanced configuration — browser config, cookies, downloads, code-server, env vars, git, lifecycle hooks, opencode, proxy, security, web terminal, workspace | Load and read `references/routers/advanced-guide-router.md` |
| Integration examples — OpenAI, LangGraph, Playwright, browser-use, AG2, MiniMax, file operations, cloud storage, Volcengine | Load and read `references/routers/examples-router.md` |
| SDK — Python (agent-sandbox), JavaScript/TypeScript (@agent-infra/sandbox), Go (sandbox-sdk-go), providers, installation | Load and read `references/routers/sdk-router.md` |
| Project README, overview, features, quick start, architecture, deployment, Docker Compose, Kubernetes | Load and read `references/codebase/README.md` |
| Contributing guide, how to contribute, development setup, pull requests | Load and read `references/codebase/CONTRIBUTING.md` |
| Evaluation, benchmark results, dataset, improvement suggestions | Explore `references/codebase/evaluation/` |
| Blog posts, announcements, changelog, release notes | Explore `references/codebase/website/docs/en/blog/` |
| Chinese documentation, 中文文档 | Explore `references/codebase/website/docs/zh/` |
| API reference, API documentation, OpenAPI schema, endpoint list, REST API | Load and read `references/supplements/api-reference.md` |
| Quick reference, cheat sheet, common commands, shortcuts, frequently used APIs | Load and read `references/supplements/cheat-sheet.md` |
| No match | Load and read `references/codebase/README.md` |

## Quick Start

```bash
# Run the sandbox
docker run --security-opt seccomp=unconfined --rm -it -p 8080:8080 ghcr.io/agent-infra/sandbox:latest

# Install Python SDK
pip install agent-sandbox

# Install TypeScript SDK
npm install @agent-infra/sandbox
```

```python
from agent_sandbox import Sandbox

client = Sandbox(base_url="http://localhost:8080")

# Shell
result = client.shell.exec_command(command="ls -la")

# File
content = client.file.read_file(file="/home/gem/.bashrc")

# Browser
screenshot = client.browser.screenshot()

# Jupyter
result = client.jupyter.execute_code(code="print(1+1)")
```

## References

- [Basic Guides](references/routers/basic-guide-router.md) — Core sandbox features (Browser, Shell, File, MCP, Code, etc.)
- [Advanced Guides](references/routers/advanced-guide-router.md) — Configuration, security, lifecycle, proxy
- [Examples](references/routers/examples-router.md) — Integration examples (OpenAI, LangGraph, Playwright, etc.)
- [SDK Documentation](references/routers/sdk-router.md) — Python, JavaScript/TypeScript, Go SDKs