Nido - VM Manager for AI Agents

Nido

为 AI Agent 提供真正的虚拟机。一个本地引擎，三种驱动方式：CLI、TUI 和 MCP。

为 Agent 提供一台可供其创建、使用和删除的机器。Nido 在本地运行 QEMU， 通过写时复制磁盘克隆缓存镜像，并将相同的虚拟机生命周期管理功能提供给 终端和 MCP 客户端。每台虚拟机都有自己的客户机内核。

孵化你的 Agent，让它们展翅飞翔。 复古 Shell，实用机械。

快速开始 · 连接 Agent · 文档 · Wiki

为什么选择 Nido？

你想要……	Nido 提供……
在宿主机之外测试代码	可通过 SSH 访问并使用 cloud-init 配置的一次性 QEMU 虚拟机
让 Agent 管理自己的环境	内置的 stdio MCP 服务，提供精简工具、只读资源和可选的事件订阅
复用耗时的环境配置	模板和 QCOW2 链接克隆，每台虚拟机共享一个基础镜像，并拥有各自可写的磁盘
在自动化和亲自操作之间切换	结构化 CLI JSON、Shell 补全和交互式终端仪表板
让多个仪表板和 Agent 保持同步	共享本地事件、实时 TUI 更新和选择性 MCP 通知
选择合适的起点	自动刷新的云镜像目录、本地模板和可构建的蓝图

快速开始

运行虚拟机需要 QEMU。Nido 支持 Linux、macOS 和 Windows 宿主机； 硬件加速取决于宿主机实际提供的功能。请从 nido doctor 开始。参见安装和宿主机要求。

安装

Linux / macOS

curl -fsSL https://github.com/Josepavese/nido/releases/latest/download/install.sh | bash

Windows PowerShell

irm https://github.com/Josepavese/nido/releases/latest/download/install.ps1 | iex

打开新的终端，然后运行 nido version 和 nido doctor 进行检查。快速 安装程序会检查先决条件，并在支持的平台上提供 QEMU 安装选项。

更喜欢使用包管理器？npm 适用于 Linux、macOS 和 Windows：

npm install -g nido-mcp                # Linux / macOS / Windows launcher
brew install Josepavese/nido/nido       # macOS / Linux
go install github.com/Josepavese/nido/v4/cmd/nido@latest

scoop bucket add nido https://github.com/Josepavese/scoop-nido
scoop install nido

容器（Docker/Podman，内置 QEMU；需要支持 KVM 的宿主机）：

docker run -i --rm --device /dev/kvm \
  --group-add "$(stat -c %g /dev/kvm)" \
  -v nido-home:/home/nido/.nido \
  ghcr.io/josepavese/nido mcp

每次发布时都会在 ghcr.io/josepavese/nido 重新构建镜像（:{version}、 :{minor}、:latest），并通过 stdio 提供 MCP 服务；请传入 --group-add， 以便非 root 用户能够打开 /dev/kvm。

WinGet：Josepavese.Nido 正在等待 Microsoft 审核。参见 可用状态和命令。

对于 MCP 客户端，可使用 npx -y nido-mcp mcp，在官方 MCP 注册表中搜索 io.github.Josepavese/nido，浏览 Glama，或导入 MCPB bundle。MCP 目录和客户端安装。

所有安装选项 · 分发渠道状态

创建你的第一个 VM

nido images update
nido images info ubuntu:lts
nido images pull ubuntu:lts
nido spawn agent-lab --image ubuntu:lts --memory 2048 --cpus 2
nido info agent-lab --json

# Once the guest has finished booting and SSH is ready:
nido ssh agent-lab

首次拉取会下载基础镜像。后续 VM 可以复用它。ubuntu:lts 会采用目录支持的 LTS 版本；如果需要指定 OS 版本，请使用 nido images list 中的编号标签。来宾系统启动和 cloud-init 还需要额外时间；创建覆盖层只是启动过程的一部分。

保存好所需工作后，请在来宾系统内关机，并且只删除 你的一次性 VM：

nido ssh agent-lab sudo poweroff
# After shutdown, confirm its state:
nido info agent-lab
nido delete agent-lab

nido stop 会终止受管理的 QEMU 进程并等待其退出。要干净地关闭 OS，请使用来宾系统的关机命令。删除 VM 前，VM 数据会一直保留。

配置、端口、模板和清理

在另一个终端中使用 nido events 或 nido events --json 查看核心变更。 TUI 会话会从共享流中更新；Agent 只会显式订阅所需的资源。请参阅事件传递和静音控制。

连接你的 Agent

Nido 的 MCP 服务通过本地 stdio 运行。无需单独的服务。 使用已安装的二进制文件：

{
  "mcpServers": {
    "nido": {
      "command": "nido",
      "args": ["mcp"]
    }
  }
}

如果客户端未继承终端的 PATH，请使用可执行文件的绝对路径。nido register 会输出注册代码块；由你的客户端决定将其保存到何处。也可以通过 command: "npx" 和 args: ["-y", "nido-mcp", "mcp"] 来启动 npm 包。

工具	职责
nido_vm	创建、检查、配置、连接和移除 VM；管理转发端口
nido_image	浏览和刷新目录；拉取并管理缓存镜像
nido_template	保存和管理可复用磁盘模板
nido_blueprint	检查并构建镜像配方
nido_system	诊断、配置、加速器和安装操作

只读资源包括 nido://fleet/vms、nido://catalog/images 和 nido://system/config。使用 nido mcp-help 查看机器可读的工具/操作 指南，或在终端中运行 nido mcp --help。

给你的 Agent 的示例任务：

创建一个名为 test-lab 的一次性 Ubuntu LTS VM，配置所需依赖， 运行我的测试并保存输出。完成后只删除该 VM。保留其他 VM 和共享镜像。

MCP 可以访问本地 VM 和安装操作，包括具有破坏性的操作。请连接你信任的客户端。MCP 指南 · 可选的 VM 测试技能

一个基础镜像。多台独立机器。

启用链接克隆后，缓存的基础镜像会保持共享，同时每台 VM 都会记录自己的磁盘变更。随着写入、日志和模板的增加，空间占用也会增长；添加 VM 并不会让空间占用保持不变。Nido 会在移除缓存前检查后备镜像依赖项。只要仍有依赖的 VM 磁盘，就请保留基础镜像。

VM 提供独立的来宾内核，但主机挂载、转发端口和 PCI 直通会有意跨越这道边界。对于任意不可信工作负载，Nido 并不是完整的安全策略。请参阅操作和隔离。

选择起点

• 云镜像：从目录拉取，并通过 cloud-init 配置。 Ubuntu、Debian、Alpine、Kali、CirrOS 和 openSUSE 的发现规则遵循 registry/sources.yaml 中的策略。目录与完整性
• 模板：保存已准备好的 VM 磁盘，以便在重复任务中重用。 模板工作流
• 蓝图：根据配方和安装介质构建镜像，包括 Windows 评估版。Windows 指南

定时运行的目录任务会发现上游发布的新支持版本。运行 nido images update 刷新 本地副本；此操作不会更新现有客户机 OS。

想亲自操作？运行 nido gui 打开 Fleet、Hatchery、Registry 和 System 视图。需要显示 VM 的画面时，可在 spawn/start 中使用 --gui； 该标志与终端仪表板是两个独立功能。

进一步探索

任务	指南
配置客户机、转发端口、调整资源、共享文件	日常工作流
编写针对 Nido 的脚本	CLI JSON 契约
安装、升级或选择软件包渠道	安装程序 · 发行版
更改终端配色方案	主题
了解运行时和硬件边界	架构
贡献或验证更改	贡献指南 · 测试

文档索引 · 更新日志 · 问题反馈 · MIT 许可证