Why you'd want it
smolvm boots any OCI image as a hardware-virtualized VM with its own guest kernel, using Hypervisor.framework on macOS, KVM on Linux or the Windows Hypervisor Platform, with no Docker daemon. Networking is off by default, egress can be limited to named hosts, and credential substitution lets code use a secret without reading it. A running machine can be checkpointed, rewound or branched into copy-on-write copies, packed into a single .smolmachine file, and driven from Node, Python or Rust SDKs that run in your process without a daemon.
Best for
- Running untrusted agent code on your own machine
- Branching an agent's environment mid-run
- Embedding VMs in your own app
Use it when
You want each agent task in a real VM on your laptop or server, with egress allow lists and the option to snapshot or branch the machine.
Skip it if
Containers or a hosted sandbox already give you enough isolation. The README calls safety a shared responsibility: every folder you mount, port you open, host you allow and secret you forward becomes usable by the workload. GPU acceleration is unavailable on Windows, and Intel macOS is marked untested.
Editor's note
The README says smolvm is the open-source runtime behind smol machines and is not affiliated with other projects named SmolVM.