Ever needed to run code you don't fully trust? Whether it's AI-generated code, user submissions, or experimental code, the traditional options all have serious drawbacks:
microsandbox combines the best of all worlds:
Get started in few easy steps:
<div align="center"> <video src="https://github.com/user-attachments/assets/23618f92-5897-44d1-bfa6-1058f30c09ef" width="800" controls> </video><sup><small><a href="https://asciinema.org/a/itQE92vIJiyq1PAPnaGURzDpv" target="_blank">[ASCIINEMA →]</a></small></sup>
</div> <div align='center'> <img src="https://img.shields.io/badge/macos-working-green?style=for-the-badge" alt=macos style="margin-bottom: 5px;"/> <img src="https://img.shields.io/badge/linux-working-green?style=for-the-badge" alt=linux style="margin-bottom: 5px;"/> <img src="https://img.shields.io/badge/windows-wip-red?style=for-the-badge" alt=windows style="margin-bottom: 5px;"/> </div> <h3><span>1</span> <img height="13" src="https://octicons-col.vercel.app/north-star/A770EF"> Start the Server</h3>curl -sSL https://get.microsandbox.dev | shmsb server start --dev[!TIP]
microsandbox server is also an MCP server, so it works directly with Claude, Agno and other MCP-enabled AI tools and agents.
For more information on setting up the server, see the self-hosting guide.
msb pull microsandbox/pythonpip install microsandboxnpm install microsandboxcargo add microsandbox<h3><span>3</span> <img height="14" src="https://octicons-col.vercel.app/file-binary/A770EF"> Execute the Code</h3>[!NOTE]
<div align="left"> <a href="./sdk/python"><img src="https://img.shields.io/badge/Python-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python"></a> <a href="./sdk/rust"><img src="https://img.shields.io/badge/Rust-000000?style=flat-square&logo=rust&logoColor=white" alt="Rust"></a> <a href="./sdk/javascript"><img src="https://img.shields.io/badge/JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=black" alt="JavaScript"></a> <a href="./sdk/c"><img src="https://img.shields.io/badge/C-606060?style=flat-square&logo=c&logoColor=white" alt="C"></a> <a href="./sdk/cpp"><img src="https://img.shields.io/badge/C++-606060?style=flat-square&logo=c%2B%2B&logoColor=white" alt="C++"></a> <a href="./sdk/crystal"><img src="https://img.shields.io/badge/Crystal-606060?style=flat-square&logo=crystal&logoColor=white" alt="Crystal"></a> <a href="./sdk/csharp"><img src="https://img.shields.io/badge/C%23-606060?style=flat-square&logo=c-sharp&logoColor=white" alt="C#"></a> <a href="./sdk/dart"><img src="https://img.shields.io/badge/Dart-606060?style=flat-square&logo=dart&logoColor=white" alt="Dart"></a> <a href="./sdk/elixir"><img src="https://img.shields.io/badge/Elixir-606060?style=flat-square&logo=elixir&logoColor=white" alt="Elixir"></a> <a href="./sdk/elm"><img src="https://img.shields.io/badge/Elm-606060?style=flat-square&logo=elm&logoColor=white" alt="Elm"></a> <a href="./sdk/erlang"><img src="https://img.shields.io/badge/Erlang-606060?style=flat-square&logo=erlang&logoColor=white" alt="Erlang"></a> <a href="./sdk/fsharp"><img src="https://img.shields.io/badge/F%23-606060?style=flat-square&logo=f-sharp&logoColor=white" alt="F#"></a> <a href="./sdk/go"><img src="https://img.shields.io/badge/Go-606060?style=flat-square&logo=go&logoColor=white" alt="Go"></a> <a href="./sdk/haskell"><img src="https://img.shields.io/badge/Haskell-606060?style=flat-square&logo=haskell&logoColor=white" alt="Haskell"></a> <a href="./sdk/java"><img src="https://img.shields.io/badge/Java-606060?style=flat-square&logo=java&logoColor=white" alt="Java"></a> <a href="./sdk/julia"><img src="https://img.shields.io/badge/Julia-606060?style=flat-square&logo=julia&logoColor=white" alt="Julia"></a> <a href="./sdk/kotlin"><img src="https://img.shields.io/badge/Kotlin-606060?style=flat-square&logo=kotlin&logoColor=white" alt="Kotlin"></a> <a href="./sdk/lua"><img src="https://img.shields.io/badge/Lua-606060?style=flat-square&logo=lua&logoColor=white" alt="Lua"></a> <a href="./sdk/nim"><img src="https://img.shields.io/badge/Nim-606060?style=flat-square&logo=nim&logoColor=white" alt="Nim"></a> <a href="./sdk/objc"><img src="https://img.shields.io/badge/Objective--C-606060?style=flat-square&logo=apple&logoColor=white" alt="Objective-C"></a> <a href="./sdk/ocaml"><img src="https://img.shields.io/badge/OCaml-606060?style=flat-square&logo=ocaml&logoColor=white" alt="OCaml"></a> <a href="./sdk/php"><img src="https://img.shields.io/badge/PHP-606060?style=flat-square&logo=php&logoColor=white" alt="PHP"></a> <a href="./sdk/r"><img src="https://img.shields.io/badge/R-606060?style=flat-square&logo=r&logoColor=white" alt="R"></a> <a href="./sdk/ruby"><img src="https://img.shields.io/badge/Ruby-606060?style=flat-square&logo=ruby&logoColor=white" alt="Ruby"></a> <a href="./sdk/scala"><img src="https://img.shields.io/badge/Scala-606060?style=flat-square&logo=scala&logoColor=white" alt="Scala"></a> <a href="./sdk/swift"><img src="https://img.shields.io/badge/Swift-606060?style=flat-square&logo=swift&logoColor=white" alt="Swift"></a> <a href="./sdk/zig"><img src="https://img.shields.io/badge/Zig-606060?style=flat-square&logo=zig&logoColor=white" alt="Zig"></a> </div>
There are SDKs for other languages as well! Join us in expanding support for your favorite language.
microsandbox offers a growing list of sandbox environment types optimized for different execution requirements. Choose the appropriate sandbox (e.g., PythonSandbox or NodeSandbox) to run your code in a secure tailored environment.
import asyncio
from microsandbox import PythonSandbox
async def main():
async with PythonSandbox.create(name="test") as sb:
exec = await sb.run("name = 'Python'")
exec = await sb.run("print(f'Hello {name}!')")
print(await exec.output()) # prints Hello Python!
asyncio.run(main())import { NodeSandbox } from "microsandbox";
async function main() {
const sb = await NodeSandbox.create({ name: "test" });
try {
let exec = await sb.run("var name = 'JavaScript'");
exec = await sb.run("console.log(`Hello ${name}!`)");
console.log(await exec.output()); // prints Hello JavaScript!
} finally {
await sb.stop();
}
}
main().catch(console.error);use microsandbox::{SandboxOptions, PythonSandbox};
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let mut sb = PythonSandbox::create(SandboxOptions::builder().name("test").build()).await?;
let exec = sb.run(r#"name = "Python""#).await?;
let exec = sb.run(r#"print(f"Hello {name}!")"#).await?;
println!("{}", exec.output().await?); // prints Hello Python!
sb.stop().await?;
Ok(())
}[!NOTE]
If you haven't pulled the environment image, the first run will take a while as it tries to download it.
Executions will be much faster afterwards.For more information on how to use the SDK, check out the SDK README.
Beyond the SDK, microsandbox supports project-based development with the familiar package-manager workflow devs are used to. Think of it like npm or cargo, but for sandboxes!
Create a Sandboxfile, define your environments, and manage your sandboxes with simple commands.
<a href="https://asciinema.org/a/7eOFf2Ovigi473FsKgr3Lpve1" target="_blank"><img src="https://github.com/user-attachments/assets/3a9d1de4-2370-4d5a-a40d-9aa7315aa934" /></a>
msb initThis creates a Sandboxfile in the current directory, which serves as the configuration manifest for your sandbox environments.
msb add app \
--image python \
--cpus 1 \
--memory 1024 \
--start 'python -c "print(\"hello\")"'The command above registers a new sandbox named app in your Sandboxfile, configured to use the python image.
You should now have a Sandboxfile containing a sandbox named app:
cat Sandboxfile# Sandbox configurations
sandboxes:
app:
image: python
memory: 1024
cpus: 1
scripts:
start: python -c "print(\"hello\")"[!TIP]
Run
msb <subcommand> --helpto see all the options available for a subcommand.For example,
msb add --help.
msb run --sandbox appor
</div>msr appThis executes the default start script of your sandbox. For more control, you can directly specify which script to run — msr app~start.
When running project sandboxes, all file changes and installations made inside the sandbox are automatically persisted to the ./menv directory. This means you can stop and restart your sandbox any time without losing your work. Your development environment will be exactly as you left it.
For experimentation or one-off tasks, temporary sandboxes provide a clean environment that leaves no trace:
msb exe --image pythonor
</div>msx pythonTemporary sandboxes are perfect for isolating programs you get from the internet. Once you exit the sandbox, all changes are discarded automatically.
The msb install command sets up a sandbox as a system-wide executable. It installs a slim launcher program that allows you to start your sandbox from anywhere in your system with a simple command.
msb install --image alpineor
</div>msi alpineAfter installation, you can start your sandbox by simply typing its name in any terminal:
alpineThis makes frequently used sandboxes incredibly convenient to access — no need to navigate to specific directories or remember complex commands. Just type the sandbox name and it launches immediately with all your configured settings.
<div align='center'>• • •</div>[!TIP]
You can give your sandbox a descriptive, easy-to-remember name during installation:msi alpine:20250108 slim-linuxThis allows you to create multiple instances of the same sandbox image with different names and configurations. For example:
msi python python-data-science- A Python environment for data analysismsi python python-web- A Python environment for web developmentInstalled sandboxes maintain their state between sessions, so you can pick up exactly where you left off each time you launch them.
<a href="https://microsandbox.dev#gh-dark-mode-only" target="_blank"><img align="right" width="400" alt="coding-dark" src="https://github.com/user-attachments/assets/37c14bf1-e2f7-4af3-804e-5901de845715"></a>
<a href="https://microsandbox.dev#gh-light-mode-only" target="_blank"><img align="right" width="400" alt="coding-light" src="https://github.com/user-attachments/assets/1bfe7223-869b-4782-9fce-3620c4400bbf"></a>
Let your AI agents build real apps with professional dev tools. When users ask their AI to create a web app, fix a bug, or build a prototype, it can handle everything from Git operations to dependency management to testing in a protected environment.
Your AI can create comprehensive development environments in milliseconds and run programs with full system access. The fast startup means developers get instant feedback and can iterate quickly. This makes it perfect for AI pair programming, coding education platforms, and automated code generation where quick results matter.
<!-- TODO: <div align="center"><a href="https://microsandbox.dev/docs/examples/coding">✨ See coding examples ✨</a></div> --> <!-- Transparent pixel to create line break after floating image --><img width="2000" height="0" src="https://github.com/user-attachments/assets/ee14e6f7-20b8-4391-9091-8e8e25561929"><br>
<a href="https://microsandbox.dev#gh-dark-mode-only" target="_blank"><img align="left" width="400" alt="data-dark" src="https://github.com/user-attachments/assets/3794e426-a223-4064-8939-025c7bbaf5ea"></a>
<a href="https://microsandbox.dev#gh-light-mode-only" target="_blank"><img align="left" width="400" alt="data-light" src="https://github.com/user-attachments/assets/3a330ea5-85b5-4176-8fe7-a43d59733cf1"></a>
Transform raw numbers into meaningful insights with AI that works for you. Your AI can process spreadsheets, create charts, and generate reports safely. Whether it's analyzing customer feedback, sales trends, or research data, everything happens in a protected environment that respects data privacy.
Microsandbox lets your AI work with powerful libraries like NumPy, Pandas, and TensorFlow while creating visualizations that bring insights to life. Perfect for financial analysis tools, privacy-focused data processing, medical research, and any situation where you need serious computing power with appropriate safeguards.
<!-- TODO: <div align="center"><a href="https://microsandbox.dev/docs/examples/data-analysis">📊 Explore data examples 📊</a></div> --> <!-- Transparent pixel to create line break after floating image --><img width="2000" height="0" src="https://github.com/user-attachments/assets/ee14e6f7-20b8-4391-9091-8e8e25561929"><br>
<a href="https://microsandbox.dev#gh-dark-mode-only" target="_blank"><img align="right" width="400" alt="web-dark" src="https://github.com/user-attachments/assets/3048a39a-c3cb-4f6e-9bc0-49b404abed03"></a>
<a href="https://microsandbox.dev#gh-light-mode-only" target="_blank"><img align="right" width="400" alt="web-light" src="https://github.com/user-attachments/assets/e6a01e6d-c23f-4c04-bfbf-3e0cb283e0a9"></a>
Build AI assistants that can browse the web for your users. Need to compare prices across stores, gather info from multiple news sites, or automate form submissions? Your AI can handle it all while staying in a contained environment.
With microsandbox, your AI can navigate websites, extract data, fill out forms, and handle logins. It can visit any site and deliver only the useful information back to your application. This makes it ideal for price comparison tools, research assistants, content aggregators, automated testing, and web automation workflows that would otherwise require complex setup.
<!-- TODO: <div align="center"><a href="https://microsandbox.dev/docs/examples/web-browsing">🌐 View web examples 🌐</a></div> --> <!-- Transparent pixel to create line break after floating image --><img width="2000" height="0" src="https://github.com/user-attachments/assets/ee14e6f7-20b8-4391-9091-8e8e25561929"><br>
<a href="https://microsandbox.dev#gh-dark-mode-only" target="_blank"><img align="left" width="400" alt="host-dark" src="https://github.com/user-attachments/assets/3c542e78-b5a0-4525-8a2a-376447d786fd"></a>
<a href="https://microsandbox.dev#gh-light-mode-only" target="_blank"><img align="left" width="400" alt="host-light" src="https://github.com/user-attachments/assets/337b3d5f-9c33-4126-ae55-aca33abbf73e"></a>
Share working apps and demos in seconds without deployment headaches. When your AI creates a useful tool, calculator, visualization, or prototype, users can immediately access it through a simple link.
Zero-setup deployment means your AI-generated code can be immediately useful without complex configuration. Each app runs in its own protected space with appropriate resource limits, and everything cleans up automatically when no longer needed. Perfect for educational platforms hosting student projects, AI assistants creating live demos, and users needing immediate value.
<!-- TODO: <div align="center"><a href="https://microsandbox.dev/docs/examples/app-hosting">🚀 Try hosting examples 🚀</a></div> --> <!-- Transparent pixel to create line break after floating image --><img width="2000" height="0" src="https://github.com/user-attachments/assets/ee14e6f7-20b8-4391-9091-8e8e25561929"><br>
<div align='center'>• • •</div>flowchart TB
%% ── Client side ──────────────────────────
subgraph ClientProcess["process"]
A["Your Business Logic"]
B["microsandbox SDK"]
A -->|calls| B
end
%% ── Server side ─────────────────────────
subgraph ServerProcess["process"]
C["microsandbox server"]
end
B -->|sends untrusted code to| C
%% ── Branching hub ───────────────────────
D([ ])
C -->|runs code in| D
%% ── Individual MicroVMs ────────────────
subgraph VM1["microVM"]
VM1S["python environment"]
end
subgraph VM2["microVM"]
VM2S["python environment"]
end
subgraph VM3["microVM"]
VM3S["node environment"]
end
D --> VM1S
D --> VM2S
D --> VM3S
%% ── Styling ─────────────────────────────
style A fill:#D6EAF8,stroke:#2E86C1,stroke-width:2px,color:#000000
style B fill:#D6EAF8,stroke:#2E86C1,stroke-width:2px,color:#000000
style C fill:#D5F5E3,stroke:#28B463,stroke-width:2px,color:#000000
style D fill:#F4F6F6,stroke:#ABB2B9,stroke-width:2px,color:#000000
style VM1S fill:#FCF3CF,stroke:#F1C40F,stroke-width:2px,color:#000000
style VM2S fill:#FCF3CF,stroke:#F1C40F,stroke-width:2px,color:#000000
style VM3S fill:#FCF3CF,stroke:#F1C40F,stroke-width:2px,color:#000000Interested in contributing to microsandbox? Check out our Development Guide for instructions on setting up your development environment, building the project, running tests, and creating releases.
For contribution guidelines, please refer to CONTRIBUTING.md.
<div align='center'>• • •</div>This project is licensed under the Apache License 2.0.
<div align='center'>• • •</div>We'd like to thank the following projects and communities that made microsandbox possible:
Special thanks to all our contributors, testers, and community members who help make microsandbox better every day!
<div align='center'>• • •</div>Thanks for all the support!
<div align='center'> <a href="https://star-history.com/#microsandbox/microsandbox&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=microsandbox/microsandbox&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=microsandbox/microsandbox&type=Date" /> <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=microsandbox/microsandbox&type=Date" /> </picture> </a> </div> <br /> <div align='center'>• • •</div>microsandbox/microsandbox
October 3, 2024
July 7, 2025
Rust