superradcompany /microsandbox

🧱 easy, fast, programmable and local-first microVM runtime and library

★ 9,075⑂ 522👁 26⑃ 1,583● 455▤ 77
RustApache-2.0Created 2024-10-03docs.microsandbox.dev
Download: v0.7.15v0.7.15 ↓0.7.152026-11-12
+13
Daily
9,075
stars
522
forks
26
watchers
1,583
prs
455
issues
77
releases

README

——   easy, fast, programmable microVMs for untrusted workloads   ——




    





  
  
  





Microsandbox runs untrusted workloads inside fast, local microVMs: AI agents, user code, plugins, CI jobs, dev environments, scrapers, and automation.



-  Hardware Isolation: Hardware-level isolation with tiny virtual machines.
-  Fork & Snapshot: Fork live sandboxes[^demo]. Save running sandbox state and restore later.
-  Cross Platform: Runs on Linux, macOS, and Windows.
-  OCI Compatible: Runs standard container images from Docker Hub, GHCR, or any OCI registry.
-  Docker-Like Workflows: Familiar image, command, shell, and volume workflows.
-  Instant Startup: Average boot times[^boot-time] under 100 milliseconds.
-  Embeddable: Spawn VMs right within your code. No setup server. No long-running daemon.
-  Secrets That Can't Leak: Unexploitable secret keys that never enter the VM.
-  Long-Running: Sandboxes can run in detached mode. Great for long-lived sessions.
-  Agent-Ready: Your agents can create their own sandboxes with our Agent Skills and MCP server.



   Getting Started

   Install the CLI
 sh
 curl -fsSL https://install.microsandbox.dev | sh         🍎 macOS / 🐧 Linux
 

 powershell
 irm https://install.microsandbox.dev/windows | iex       🪟 Windows
 

 
  We also support other package managers  →

 

 sh
 brew install superradcompany/tap/microsandbox
 

 sh
 npm i -g microsandbox
 

 sh
 uv tool install microsandbox
 

 sh
 cargo install microsandbox
 

 

 

 Start creating sandboxes once installed:

 sh
 msb run ubuntu
 

   Install the SDK
 sh
 npm i microsandbox                                        🟦 TypeScript
 

 sh
 cargo add microsandbox                                    🦀 Rust
 

 sh
 uv add microsandbox                                       🐍 Python
 

 sh
 go get github.com/superradcompany/microsandbox/sdk/go     🐹 Go
 




 Requirements:

 -  macOS: Apple Silicon.
 -  Linux: KVM enabled.
 -  Windows: WHP enabled.

 Warning: Microsandbox is still beta software. Expect breaking changes, missing features, and rough edges.



   CLI

The msb CLI provides a complete interface for managing sandboxes, snapshots, images, and volumes.

   Run a Command

 sh
 msb run python -- python3 -c "print('Hello from a microVM!')"
 

   Named Sandboxes

 sh
  Create and start a named sandbox
 msb create --name app python
 

 sh
  Execute commands
 msb exec app -- python -c "import this"
 msb exec app -- curl https://example.com
 

 sh
  Fork a running sandbox.
 msb fork app --name app2
 msb exec app2 -- python -c "print('An independent copy!')"
 

 sh
  Snapshot now, resume later.
 msb snap create --sandbox app --full -o snapshot.msb
 msb snap restore snapshot.msb --name app3
 

 Forking duplicates live execution. Restoring starts from saved state; add --cow-mem to share unchanged memory from a full snapshot. Snapshot generations describe progression

Top issues

Discussions

Latest release

v0.7.15 v0.7.15 2026-11-12
What's Changed
 Features
 feat(release): add opt-in candidate installs and publishing by @appcypher in https://github.com/superradcompany/microsandbox/pull/2008
 Performance
 perf(filesystem): cut per-file host operations on passthrough mounts by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/2032
 Maintenance
 chore: refresh lockfiles after v0.7.14 by @github-actions[bot] in https://github.com/superradcompany/microsandbox/pull/2035
 chore(release): bump microsandbox to 0.7.15 by @appcypher in https://github.com/superradcompany/microsandbox/pull/2040


Full Changelog: http

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON