LibreAI / AI Agents / smolvm
// agents · smol-machines/smolvm

smolvm

An embeddable, portable, branchable microVM that runs AI agents safely on your own machine.

★ 6.6k stars⑂ 324 forksApache-2.0updated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

smolvm is an open-source ai agents project by smol-machines (smol-machines/smolvm on GitHub). It has 6,616 GitHub stars and 324 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 8 October 2026.

GitHub stars
6,616
Forks
324
License
Apache-2.0
Last updated on GitHub
8 October 2026
Category
AI Agents
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your isolation goal

    Decide which agent or untrusted workload you want to run inside a hardware-isolated VM instead of directly on your host.

  2. Install the CLI

    Install smolvm with Homebrew on macOS or the install script on macOS and Linux.

  3. Configure the machine

    Create a machine from an OCI image or a local Docker image, and explicitly allow only the network hosts, mounts and ports it needs.

  4. Run your first workload

    Run a one-off command in a disposable VM, or start a named machine and exec into it.

// features

Why people love it

Hardware-isolated microVMs

Each workload runs in its own VM with its own kernel, built on libkrun, so agent code never runs directly on the host.

Branchable checkpoints

Save a running machine mid-execution, rewind it, or branch it into copy-on-write copies that keep running from the same point; checkpoints capture RAM, CPU state and disks.

Portable machine files

Pack a configured machine into a single .smolmachine file, push it to any OCI registry, or ship it as a self-contained executable; checkpoints restore on another host.

Safe by default networking

Networking is off by default and egress can be limited to named hosts; workloads can use a credential without ever reading it.

Docker image friendly

Run existing images directly, including piping a local image in with docker save — no registry required.

Embeddable SDKs

Drive machines from Node/TypeScript (npm install smolmachines), Python (pip install smolmachines) or Rust (cargo add smolmachines).

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Clone smolvm to read the source and docs (the CLI itself installs via the script in the next step).

    git clone https://github.com/smol-machines/smolvm.git
    cd smolvm
  2. Install the CLI

    Install smolvm on macOS with Homebrew, or on macOS/Linux with the official install script.

    brew install smol-machines/tap/smolvm
    # or: curl -sSL https://smolmachines.com/install.sh | bash
  3. Run your first VM

    Run a one-off Alpine VM with networking enabled, removed on exit.

    smolvm machine run --net --image alpine -- uname -a
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains smolvm?

smol-machines maintains smolvm, with documentation and SDKs published at smolmachines.com.

Is smolvm free?

Yes — it is open source under the Apache-2.0 license. The project also offers a hosted smol cloud for restoring checkpoints, which is separate from the local runtime.

Does it need a paid API key?

No. smolvm is a local VM runtime; it runs whatever images and commands you give it and needs no LLM or cloud API key.

How does it compare to Docker?

Docker containers share the host kernel; smolvm gives every workload its own kernel in a hardware-isolated microVM, and adds checkpoint, rewind and branching of live machines.

How do I get started?

Install the CLI, then run smolvm machine run --net --image alpine -- /bin/sh for an interactive shell in a throwaway VM.

// keep exploring

Similar tools

AI Agents

yao

All your agents and workspaces in one place — on every device you own.

★ 8.1k starsNOASSERTION
View guide →
AI Agents

julep

Durable, composable AI agents — flows that crash and resume, retry safely, and explain every step.

★ 6.6k starsApache-2.0
View guide →
AI Agents

OpenSandbox

A secure, fast sandbox runtime where AI agents can execute safely.

★ 15.7k starsApache-2.0
View guide →
AI Agents

zero

A coding agent that runs on your model, your machine, your rules.

★ 1.7k starsMIT
View guide →
AI Agents

generative_agents

Stanford's Generative Agents simulation - 25 AI characters living in a virtual town

★ 22.2k starsApache-2.0
View guide →
AI Agents

OpenBot

Open-source AI coworkers, each with a computer of their own.

★ 6.2k starsMIT
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if smolvm is not the right fit.

Get smolvm

Free and open — grab the source, star the repo, and start creating.