# agent-infra/sandbox

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/agent-infra-sandbox).**

2,569 stars · 229 forks · Python · apache-2.0

## Links

- GitHub: https://github.com/agent-infra/sandbox
- Homepage: https://sandbox.agent-infra.com
- awesome-repositories: https://awesome-repositories.com/repository/agent-infra-sandbox.md

## Topics

`agent` `all-in-one` `browser` `filesystem` `mcp` `sandbox` `shell`

## Description

This project provides secure, containerized infrastructure designed for autonomous agents, remote code execution, and cloud development. It functions as a sandboxed environment where AI agents and external processes can execute code, run shell commands, and manage files while remaining isolated from the host system.

The system distinguishes itself by implementing the Model Context Protocol, allowing it to act as a standardized tool server that exposes browser and filesystem capabilities to compatible clients. It further integrates headless browser automation, enabling programmatic web navigation and screenshot capture within the isolated workspace.

The platform covers a broad capability surface, including multi-runtime command execution, dynamic port forwarding for application previewing, and shared filesystem coordination. It also provides interactive development tools such as web-based editors, terminals, and notebooks for real-time activity inspection.

## Tags

### Artificial Intelligence & ML

- [Autonomous Agent Infrastructures](https://awesome-repositories.com/f/artificial-intelligence-ml/autonomous-agent-infrastructures.md) — Provides a secure, isolated infrastructure where AI agents can execute code and manage files safely.
- [MCP Protocol Integrations](https://awesome-repositories.com/f/artificial-intelligence-ml/external-tool-integrations/mcp-protocol-integrations.md) — Provides a standardized interface for discovery and execution of tools within an isolated environment via the Model Context Protocol. ([source](https://sandbox.agent-infra.com/guide/start/agent-sandbox))
- [MCP Servers](https://awesome-repositories.com/f/artificial-intelligence-ml/mcp-servers.md) — Implements the Model Context Protocol to expose browser and filesystem tools to large language models.
- [Model Context Protocol Servers](https://awesome-repositories.com/f/artificial-intelligence-ml/model-context-protocol-servers.md) — Implements a standardized server that exposes browser and filesystem capabilities to AI agents via the Model Context Protocol. ([source](https://cdn.jsdelivr.net/gh/agent-infra/sandbox@main/README.md))

### Software Engineering & Architecture

- [Container Isolation](https://awesome-repositories.com/f/software-engineering-architecture/execution-control/namespace-isolation/namespace-provisioners/container-isolation.md) — Runs code and shell commands inside secure isolated containers to protect the host system from malicious execution.
- [Agent Process Isolation](https://awesome-repositories.com/f/software-engineering-architecture/execution-control/namespace-isolation/namespace-provisioners/container-isolation/agent-process-isolation.md) — Implements agent process isolation using container boundaries to protect the host system. ([source](https://sandbox.agent-infra.com/guide/start/agent-sandbox))
- [Tool Exposure Interfaces](https://awesome-repositories.com/f/software-engineering-architecture/tool-exposure-interfaces.md) — Exposes browser and file system capabilities as standardized servers for autonomous agents to discover and call.

### Data & Databases

- [Sandboxed File Systems](https://awesome-repositories.com/f/data-databases/data-engineering-infrastructure/data-persistence-storage/data-storage/file-based-storage/local-file-storage/sandboxed-file-systems.md) — Implements isolated directory structures that allow secure reading, writing, and searching of files within the sandbox. ([source](https://cdn.jsdelivr.net/gh/agent-infra/sandbox@main/README.md))
- [Virtualized Filesystem Layers](https://awesome-repositories.com/f/data-databases/storage-abstraction/local-filesystem-storage/virtualized-filesystem-layers.md) — Coordinates a unified virtualized storage layer where files are immediately accessible across all runtime tools and environments.
- [Unified Storage Layers](https://awesome-repositories.com/f/data-databases/file-sharing-management/unified-storage-layers.md) — Coordinates a unified storage layer where files are immediately accessible across all runtime tools. ([source](https://sandbox.agent-infra.com/guide/start/introduction))

### Development Tools & Productivity

- [Agent Sandboxes](https://awesome-repositories.com/f/development-tools-productivity/agent-sandboxes.md) — Provides isolated agent sandboxes for secure code execution and tool access.
- [Secure Cloud Development Environments](https://awesome-repositories.com/f/development-tools-productivity/development-environment-management/development-environments/cloud-remote-workspaces/secure-cloud-development-environments.md) — Provisioning isolated cloud-based development workspaces with integrated editors and terminals for real-time coding.
- [Shell Command Execution](https://awesome-repositories.com/f/development-tools-productivity/shell-command-execution.md) — Enables running command-line instructions within an isolated container and returning the output for processing. ([source](https://sandbox.agent-infra.com/))
- [Sandbox Management Interfaces](https://awesome-repositories.com/f/development-tools-productivity/execution-sandboxes/task-sandboxing/sandbox-provider-interfaces/sandbox-management-interfaces.md) — Provides a dedicated command-line interface to execute browser and tool calls from within a container. ([source](https://sandbox.agent-infra.com/guide/start/agent-sandbox))
- [Headless Browser Automation](https://awesome-repositories.com/f/development-tools-productivity/headless-browser-automation.md) — Enables programmatic control of browser engines for web navigation and data extraction within an isolated environment.
- [Development Workspaces](https://awesome-repositories.com/f/development-tools-productivity/isolated-execution-environments/development-workspaces.md) — Provides ephemeral, isolated development workspaces equipped with a web editor and terminal.

### DevOps & Infrastructure

- [Container Command Execution](https://awesome-repositories.com/f/devops-infrastructure/container-command-execution.md) — Executes scripts and shell commands across diverse runtime environments within a secure, controlled container. ([source](https://sandbox.agent-infra.com/guide/start/quick-start))
- [Code Execution Sandboxes](https://awesome-repositories.com/f/devops-infrastructure/execution-environments/code-execution-runtimes/code-execution-sandboxes.md) — Provides secure, isolated environments designed to execute arbitrary scripts or code while preventing host system access. ([source](https://sandbox.agent-infra.com/guide/start/introduction))
- [Remote Command Execution](https://awesome-repositories.com/f/devops-infrastructure/remote-command-execution.md) — Enables triggering of shell commands, file operations, and browser actions from external processes via network interfaces. ([source](https://sandbox.agent-infra.com/guide/start/agent-sandbox))
- [Remote Tool Orchestrations](https://awesome-repositories.com/f/devops-infrastructure/remote-tool-orchestrations.md) — Exposes shell, file, and browser capabilities as standardized network interfaces for remote triggering.
- [Agentic Workspace Provisioning](https://awesome-repositories.com/f/devops-infrastructure/virtualization-environments/automated-provisioning/agentic-workspace-provisioning.md) — Automates the creation of isolated workspaces containing an editor and terminal for AI agents. ([source](https://sandbox.agent-infra.com/))
- [Service Exposure](https://awesome-repositories.com/f/devops-infrastructure/service-exposure.md) — Forwards ports from a sandbox to the cloud for instant previewing of hosted applications. ([source](https://sandbox.agent-infra.com/))

### Programming Languages & Runtimes

- [Multi-Language Runtime Support](https://awesome-repositories.com/f/programming-languages-runtimes/multi-language-runtime-support.md) — Supports shell commands and scripts across diverse language runtimes within a single coordinated workspace.
- [Remote Execution Engines](https://awesome-repositories.com/f/programming-languages-runtimes/remote-execution-engines.md) — Provides an isolated runtime for executing scripts and system commands across multiple languages in a secure container.

### Web Development

- [Browser Automation](https://awesome-repositories.com/f/web-development/browser-automation.md) — Allows controlling a headless web browser via a remote interface to interact with websites and download files. ([source](https://sandbox.agent-infra.com/guide/start/introduction))
- [Browser Control APIs](https://awesome-repositories.com/f/web-development/web-automation-scraping/browser-control-protocols/browser-control-apis.md) — Provides an HTTP-based interface for programmatic control over browser instances, including navigation and screenshot capture.

### Networking & Communication

- [Dynamic Port Forwarding](https://awesome-repositories.com/f/networking-communication/network-port-forwarding/dynamic-port-forwarding.md) — Proxies internal container ports to cloud domains for real-time previewing of applications running in the sandbox.
- [Traffic Routing](https://awesome-repositories.com/f/networking-communication/traffic-routing.md) — Exposes internal container ports through domains and proxies for testing and previewing deployed applications. ([source](https://sandbox.agent-infra.com/guide/start/introduction))

### Security & Cryptography

- [Sandbox Container Lifecycle Managers](https://awesome-repositories.com/f/security-cryptography/security/infrastructure-and-hardware/infrastructure-system-hardening/execution-sandboxes/container-based-sandboxes/sandbox-container-lifecycle-managers.md) — Manages the lifecycle of multiple isolated containers simultaneously to run parallel experiments or batch tasks. ([source](https://sandbox.agent-infra.com/guide/start/agent-sandbox))

### Part of an Awesome List

- [Agent Frameworks](https://awesome-repositories.com/f/awesome-lists/ai/agent-frameworks.md) — Containerized sandbox for agent execution.
