Skip to main content

Welcome to VoidRun

VoidRun is a modern sandbox environment that provisions highly secure, isolated MicroVMs for AI agents and developers. Execute code safely with production-grade security and lightning-fast performance.

πŸš€ Quick Start

Get up and running with VoidRun in under 5 minutes.

πŸ“š Core Concepts

Understand sandboxes, lifecycle, and execution models.

What is VoidRun?

VoidRun provides isolated MicroVM environments designed for AI workloads and developer tooling. Whether you’re building AI agents, code interpreters, or CI/CD pipelines, VoidRun offers the security and flexibility you need.

Key Features

⚑ Performance

Sandboxes run without a hard timeout. Idle sandboxes auto-sleep and wake on the next request in a fraction of a second.

🐳 Flexible Environments

Custom Docker images supported. Run Docker and K3s natively inside sandboxes.

πŸ”’ Security

Granular internet access control with allowlists and blocklists. Native Tailscale VPN connectivity.

πŸ’» Code Execution

Full code interpreter capabilities. Install Ubuntu, Python, and TypeScript packages dynamically.

🌐 Direct Access

Interact with sandboxes via VNC and SSH for debugging and development.

πŸ”‘ Simple Auth

API key authentication via the X-API-Key header; SDKs use VR_API_KEY (see SDKs and API). Self-hosted: override the API base URL with VR_API_URL or constructor options.

How It Works

VoidRun architecture is built on MicroVMs for maximum isolation and security:
1

Create a Sandbox

Provision an isolated MicroVM with your preferred configuration and base image.
2

Execute Code

Run commands, upload files, and execute code in multiple languages securely.
3

Manage Lifecycle

Sandboxes run without a hard timeout, auto-sleep when idle, and wake on the next request.
4

Clean Up

Delete sandboxes when finished, or let them stay snapshotted for later use.

Use Cases

AI Code Execution

Build AI agents that can safely execute generated code in isolated environments:

Development Environments

Spin up ephemeral development environments with custom tooling:

Who is VoidRun For?

Next Steps

Ready to start building? Check out the Quickstart Guide to create your first sandbox.

Examples

Step-by-step sandbox patterns (interpreter, CI, ETL, PTY, watch, cleanup), each on its own page.

SDKs & API

TypeScript and Python packages, auth headers, env vars, and REST overview.

VoidRun MCP

Cursor and other MCP clients: install mcp.json, auth, tools, resources, and agent-oriented response shapes.

OpenAPI & HTTP

How the REST API relates to the SDKs and error payloads.

Resources

πŸ“Š Dashboard

Manage your sandboxes at dash.void-run.com

πŸ™ GitHub

Star us on GitHub

πŸ’¬ Community

Issues, releases, and updates on GitHub.