agent-infra / sandbox

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: For users in mainland China: Use a specific version in the format , for example, to use version 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** **TypeScript/JavaScript** **Golang** Basic Usage **Python Example** **TypeScript Example** 🌟 Key Features 🔗 Unified Environment All components run in the same container with a shared filesystem, enabling seamless workflows: 🌐 Browser Automation Full browser control through multiple interfaces: • **VNC** - Visual browser interaction through remote desktop • **CDP** - Chrome DevTools Protocol for programmatic control • **MCP** - High-level browser automation tools 💻 Development Tools Integrated development environment with: • **VSCode Server** - Full IDE experience in browser • **Jupyter Notebook** - Interactive Python environment • **Terminal** - WebSocket-based terminal access • **Port Forwarding** - Smart preview for web applications 🤖 MCP Integration Pre-configured Model Context Protocol servers: • **Browser** - Web automation and scraping • **File** - File system operations • **Shell** - Command execution • **Markitdown** - Document processing 📚 Complete Example Convert a webpage to Markdown with embedded screenshot: 🏗️ Architecture 🛠️ API Reference Core APIs | Endpoint | Description | |----------|-------------| | | Get sandbox environment information | | | Execute shell commands | | | Read file contents | | | Write file contents | | | Take browser screenshot | | | Execute Jupyter code | MCP Servers | Server | Tools Available | |--------|----------------| | | , , , , | | | , , , , | | | , , | | | , , | 🚢 Deployment Docker Compose Kubernetes 🤝 Integration Examples Browser Use Integration LangChain Integration OpenAI Assistant Integration 🤝 Contributing We welcome contributions! Please see our Contributing Guide for details. 📄 License AIO Sandbox is released under the Apache License 2.0. 🙏 Acknowledgments Built with ❤️ by the Agent Infra team. Special thanks to all contributors and the open-source community. 📞 Support • 📖 Documentation • 💬 GitHub Discussions • 🐛 Issue Tracker --- Ready to revolutionize your AI development workflow? ⭐ Star us on GitHub • 📚 Read the Docs • 🐛 Report Issues