Sandbox

安装配置

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

README 摘要

# AIO Sandbox - All-in-One Agent Sandbox Environment 🌐 Browser | 💻 Terminal | 📁 File | 🔧 VSCode | 📊 Jupyter | 🤖 MCP 🌐 Website&nbsp&nbsp | &nbsp&nbsp🔌 API&nbsp&nbsp | &nbsp&nbsp📑 Paper&nbsp&nbsp | &nbsp&nbsp🌟 Examples&nbsp&nbsp | &nbsp&nbsp📊 Evaluation &nbsp&nbsp  ## 🚀 Quick Start Get up and running in 30 seconds: ```bash docker run --security-opt seccomp=unconfined --rm -it -p 8080:8080 ghcr.io/agent-infra/sandbox:latest ``` For users in mainland China: ```bash docker run --security-opt seccomp=unconfined --rm -it -p 8080:8080 enterprise-public-cn-beijing.cr.volces.com/vefaas-public/all-in-one-sandbox:latest ``` Use a specific version in the format `agent-infra/sandbox:${version}`, for example, to use version 1.0.0.150: ```bash docker run --security-opt seccomp=unconfined --rm -it -p 8080:8080 ghcr.io/agent-infra/sandbox:1.0.0.150 # or users in mainland China docker run --security-opt seccomp=unconfined --rm -it -p 8080:8080 enterprise-public-cn-beijing.cr.volces.com/vefaas-public/all-in-one-sandbox:1.0.0.150 ``` Once running, access the environment at: - 📖 **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 ## 🎯 What is AIO Sandbox? 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. Built on cloud-native lightweight sandbox technology, it provides a unified, secure execution environment for AI agents and developers. ### Why Choose AIO Sandbox? Traditional sandboxes are **single-purpose** (browser, code, or shell), making file sharing and functional coordination extremely challenging. AIO Sandbox solves this by providing: - ✅ **Unified File System** - Files downloaded in browser are instantly available in Shell/File operations - ✅ **Multiple Interfaces** - VNC, VSCode, Jupyter, and Terminal in one unified environment - ✅ **Secure Execution** - Sandboxed Python and Node.js execution with safety guarantees - ✅ **Zero Configuration** - Pre-configured MCP servers and development tools ready to use - ✅ **Agent-Ready** - MCP-compatible APIs for seamless AI agent integration ## 📦 Installation ### SDK Installation **Python** ```bash pip install agent-sandbox ``` **TypeScript/JavaScript** ```bash npm install @agent-infra/sandbox ``` **Golang** ```bash go get github.com/agent-infra/sandbox-sdk-go ``` ### Basic Usage **Python Example** ```python from agent_sandbox import Sandbox # Initialize client client = Sandbox(base_url="http://localhost:8080") home_dir = client.sandbox.get_context().home_dir # Execute shell commands result = client.shell.exec_command(command="ls -la") print(result.data.output) # File operations content = client.file.read_file(file=f"{home_dir}/.bashrc") print(content.data.content) # Browser automation screenshot = client.browser.screenshot() ``` **TypeScript Example** ```typescript import { Sandbox } from '@agent-infra/sandbox'; // Initialize client const sandbox = new Sandbox({ baseURL: 'http://localhost:8080' }); // Execute shell commands const result = await sandbox.shell.exec({ command: 'ls -la' }); console.log(result.output); // File operations co...