smolvm
An embeddable, portable, branchable virtual machine to safely run Agents locally.
What is smolvm?
An embeddable, portable, branchable virtual machine to safely run Agents locally.
Overview of smolvm
What it is
smolvm is an embeddable, portable, branchable virtual machine designed to safely run AI agents locally. It provides lightweight microVMs that can be embedded into software, used as portable development environments, or for local sandboxing.
Key features
- Real VMs with their own kernel, boot in under a second, with elastic memory (host commits only what the guest uses).
- Drive machines from code using the Machine API; SDKs available for Node/TypeScript, Python, Rust, and Go.
- Save, rewind, and branch running machines mid-execution using checkpoints; branches are copy-on-write children.
- Pack a machine into a single
.smolmachinefile, push to any OCI registry, or run as a self-contained executable. - Hardware-isolated VM with its own guest kernel; networking is off by default; egress can be limited to named hosts; credential substitution prevents secrets from being read.
- Supports macOS (Hypervisor.framework), Linux (KVM), and Windows (Windows Hypervisor Platform).
- Uses OCI images (e.g., from Docker Hub) without requiring a Docker daemon.
Use cases
- Running AI agents locally with hardware isolation.
- Creating portable development environments that can be shared and versioned.
- Sandboxing untrusted code or workloads.
- Embedding lightweight VMs into applications for safe execution.
Getting started
Install smolvm:
brew install smol-machines/tap/smolvm # macOS (Homebrew)
curl -sSL https://smolmachines.com/install.sh | bash # macOS + Linux
For Windows, unzip the windows-x86_64 release and run smolvm.exe (requires Windows Hypervisor Platform).
Quick start:
smolvm machine run --net --image alpine -- uname -a # one-off VM, removed on exit
smolvm machine run --net -it --image alpine -- /bin/sh # interactive shell
License and pricing
Licensed under Apache-2.0. Open source and free to use.
Based on the project's public README and repository metadata.