AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月18日
可嵌入、可分支的 microVM,用于在本地安全运行 AI Agent 和代码。
smolvm 是一个用 Rust 编写的虚拟机工具,基于 microVM 为每个工作负载提供独立内核的硬件隔离环境。它既能作为命令行工具在本地创建、运行和打包虚拟机,也能通过 Node、Python、Rust、Go SDK 嵌入到自己的程序中,用于安全执行 Agent 生成的代码。
推荐指数
面向 Agent 沙箱场景设计,隔离性和可分支能力突出,适合需要本地安全执行代码的开发者。
总 Star 排名
#923
雷达追踪的 3,931 个 AI 仓库中
创建于
2025
2025年12月19日
核心亮点
1硬件级隔离
每个工作负载使用独立内核的 microVM,网络默认关闭。
2可分支快照
可保存运行中机器的内存、CPU 和磁盘状态,并派生出写时复制子机。
3多语言 SDK
提供 Node、Python、Rust、Go 的 Machine API,无需常驻守护进程。
4可移植打包
可将机器打包为单个 .smolmachine 文件,推送到 OCI 仓库或作为独立可执行文件运行。
5启动快
README 称虚拟机启动在 1 秒内,打包后的可执行文件启动在 200ms 内。
适用场景
AI Agent 代码执行沙箱
例如:Agent 生成 Python 脚本后,通过 SDK 在一次性 microVM 中执行并取回输出。
本地开发环境隔离
例如:用 Smolfile 声明镜像、端口和挂载,启动带自动端口映射的开发机。
并行实验与回滚
例如:从运行中的 Agent 机器分支出多个副本,分别尝试不同操作,失败可回退到检查点。
受限网络访问
例如:只允许访问 registry.npmjs.org,其余出站请求被阻断。
它是怎么工作的
第 1 步
创建 microVM
通过 CLI 或 SDK 指定 OCI 镜像创建机器,每个机器拥有独立内核。
第 2 步
隔离运行
在虚拟机内执行命令或启动服务,网络默认关闭,按需开放主机和端口。
第 3 步
快照与分支
对运行中的机器做检查点,保存内存和磁盘状态,或派生出写时复制子机。
第 4 步
打包分发
将机器打包为 .smolmachine 文件,推送到 OCI 仓库或在其他主机恢复。
快速上手
- 1
安装
macOS 可用 Homebrew,macOS 和 Linux 可用安装脚本。
brew install smol-machines/tap/smolvm - 2
运行一次性虚拟机
启动 Alpine 并执行命令,退出后自动删除。
smolvm machine run --net --image alpine -- uname -a - 3
进入交互式 Shell
以交互模式启动虚拟机。
smolvm machine run --net -it --image alpine -- /bin/sh - 4
用 SDK 调用
安装 Node 包后在代码中创建机器并执行命令。
npm install smolmachines
适合谁
- 需要为 AI Agent 提供代码执行沙箱的开发者
- 希望本地隔离运行不可信代码的团队
- 需要快照、分支和回滚能力的实验平台
不太适合
- 只需要轻量容器隔离、不要求独立内核的用户
- 无法使用硬件虚拟化的环境
成熟度
- 活跃度2026 年 11 月仍有更新,star 超过 7000。
- 文档README 覆盖安装、SDK、分支、打包和安全,并有 docs 目录和多语言说明。
- 社区有 Discord 和 371 个 fork,但仍有 121 个未关闭 issue。
- 上手难度提供 Homebrew 和安装脚本,CLI 命令直观,SDK 安装简单。
同类项目怎么选
- Firecracker更底层的 microVM 实现,smolvm 在其思路上提供 CLI、SDK 和分支打包等上层能力。
- gVisor以用户态内核实现隔离,不是独立内核的硬件虚拟化。
- Docker容器共享宿主内核,隔离强度低于 microVM。
使用前注意
- · Windows 需要 Windows Hypervisor Platform,且仅提供解压版。
- · 网络默认关闭,挂载目录、开放端口和转发凭据都会扩大工作负载可访问范围。
- · 分支、检查点和打包等高级功能需参考 docs 中的具体限制。
- · 采用 Apache-2.0 许可,商用前建议确认依赖和分发方式。
