smolvm

smolvm 简介

smolvm 是一个用 Rust 编写的可嵌入、可移植、可分支的微虚拟机（microVM），旨在让 AI Agent 在本地安全地运行。每个工作负载都运行在拥有独立内核的硬件虚拟化虚拟机中，既具备容器般的轻量体验，又提供虚拟机级别的隔离。

核心特性

• 本地运行：在笔记本或自有服务器上启动真实虚拟机，启动时间低于 1 秒，内存弹性分配，仅占用实际使用量。
• 可嵌入：通过统一的 Machine API 从代码中驱动虚拟机，提供 Node/TypeScript、Python、Rust、Go SDK，无需守护进程。
• 可分支：支持对运行中的虚拟机进行快照、回滚和分支（写时复制），便于调试、实验和并行任务。
• 可移植：将虚拟机打包为单个 .smolmachine 文件，可推送到 OCI 仓库或作为独立可执行文件分发，启动仅需 200ms。
• 安全隔离：默认关闭网络，可限制出口主机，支持凭据替换（代码使用凭据但无法读取明文）。

快速开始

安装（macOS/Linux）：

brew install smol-machines/tap/smolvm
# 或
curl -sSL https://smolmachines.com/install.sh | bash

运行一次性虚拟机：

smolvm machine run --net --image alpine -- uname -a

交互式 Shell：

smolvm machine run --net -it --image alpine -- /bin/sh

使用场景

• AI Agent 沙箱：安全执行 LLM 生成的代码，避免影响宿主机。
• 可移植开发环境：将配置好的环境打包，随处运行。
• 分支实验：从运行中的状态创建多个副本，并行测试不同方案。

工作原理

smolvm 基于 libkrun 作为 VMM，使用 libkrunfw 提供客户机内核，底层利用各平台的硬件虚拟化能力（macOS Hypervisor.framework、Linux KVM、Windows Hypervisor Platform）。镜像采用 OCI 标准，可直接运行 Docker Hub 或 ghcr.io 上的镜像，无需 Docker 守护进程。

注意事项

• 需要宿主机开启硬件虚拟化支持。
• 网络默认关闭，需通过 --net 及允许规则显式开放。
• Windows 用户需启用 Windows Hypervisor Platform。

更多文档请参考仓库中的 docs/ 目录，包含中文 README。