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 .smolmachine file, 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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/smol-machinessmolvm.svg)](https://yunodb.com/tools/smol-machinessmolvm?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/smol-machinessmolvm?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/smol-machinessmolvm.svg" alt="Featured on YunoDB" height="20"></a>