superradcompany /microsandbox
🧱 easy, fast, programmable and local-first microVM runtime and library
★ 9,075⑂ 522👁 26⑃ 1,583● 455▤ 77
+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 progressionTop issues
#291GPU Support22 comments · 2025-07-07#1773How should DNS resolution work with outbound proxies?11 comments · 2026-10-06#1562Allow opting out of `exec.log` capture (per sandbox and/or per exec) — interactive sessions are currently written to disk chunk by chunk7 comments · 2026-09-12#1736No way to create ephemeral sandbox from existing snapshot with changed `proxy` field6 comments · 2026-10-02#1538Allow modifing network rules of a running sandbox6 comments · 2026-09-08#1870Nono.sh inside Microsandbox?5 comments · 2026-10-16#1305Runtime (msb + libkrunfw) delivery for the SDKs — continuing the #1283 discussion5 comments · 2026-08-10#1253Proposal: add an official .NET SDK5 comments · 2026-08-01
Discussions
#2042Documenting what agentd needs from the guest kernel?0 comments · 2026-11-10#1962Can I run GUI programs in microsandbox?1 comments · 2026-10-29#1865Measix Runcove: persistent MCP workspaces built on microsandbox0 comments · 2026-10-16#1577Connecting to a local domain1 comments · 2026-09-14#1345TLS proxy Interceptor hook.7 comments · 2026-08-14#1121"Inline secret values are not supported" but how to specify the host environment variable along with the allowed host?2 comments · 2026-07-06#936Limiting AI agents provisioning capabilities0 comments · 2026-06-07#728Can the --entrypoint command take any arguments?6 comments · 2026-05-15
Latest release
v0.7.15 v0.7.15 2026-11-12What'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