Nido

> "Hatch your agents. Let them fly." 🐣💾

[](https://github.com/Josepavese/nido/releases) [](LICENSE) [](https://goreportcard.com/report/github.com/Josepavese/nido)

Nido is the retro-futuristic nest for your AI agents. It spawns real Virtual Machines in milliseconds, giving your autonomous code a safe place to hatch, grow, and execute.

Containers are cages. Nido is a habitat. 🪺

Built on QEMU and fueled by 80s nostalgia, Nido feels like a game console for DevOps. It provides a full, unconstrained OS for your agents to explore, break, and rebuild.

---

🕹️ The Game Loop: Spawn -> Execute -> Destroy

1. INSERT COIN (Spawn): An agent needs a body. Nido "hatches" a VM from a cached genetic sequence (Image) instantly using Linked Clones technology.
2. PLAY (Execute): The VM is alive. The agent connects via SSH (Neural Link) and has full root access. No shared kernels. No rules.
3. GAME OVER (Destroy): The mission is complete. The VM is vaporized. The nest remains pristine for the next player.

---

⚡ Loading... (Installation)

> SYSTEM REQUIREMENTS: Linux, macOS, Android (Termux), or Windows (WSL2/PowerShell). QEMU is required to run VMs; the quick installers check for it and offer to install it where supported. On Windows, the installer can also register/install winget and enable Windows Hypervisor Platform for WHPX acceleration.

> WINDOWS STATUS: Windows host support is now smoke-tested on a real Windows VM: online installer parsing, nido doctor, catalog/blueprint listing, and basic VM lifecycle passed. Treat it as usable for core workflows, but still young compared with Linux/macOS; it needs heavier long-running and workload-specific testing.

💾 Quick Install (Web)

Run this command in your terminal. Do not turn off the console while saving.

Linux & macOS:

{ curl -fsSL https://github.com/Josepavese/nido/releases/latest/download/install.sh || curl -fsSL https://raw.githubusercontent.com/Josepavese/nido/main/installers/quick-install.sh; } | bash
# Restart your terminal or source your config to initialize the matrix
source ~/.bashrc  # or ~/.zshrc, power up the path
nido version         # Check checksum

Windows (PowerShell):

try { irm https://github.com/Josepavese/nido/releases/latest/download/install.ps1 | iex } catch { irm https://raw.githubusercontent.com/Josepavese/nido/main/installers/quick-install.ps1 | iex }
# Restart your terminal to initialize the matrix
nido version

ARM Linux SBCs:

Run this inside your favorite ARM-based Linux distro (Raspberry Pi, Pine64, etc). Android/Termux users should prefer the source installer when Android-specific packages are needed.

{ curl -fsSL https://github.com/Josepavese/nido/releases/latest/download/install.sh || curl -fsSL https://raw.githubusercontent.com/Josepavese/nido/main/installers/quick-install.sh; } | bash
# Reload your config
source ~/.bashrc
nido version

🪄 Cheat Codes (Auto-Complete)

Tab-completion is enabled by default. If it's missing, equip it manually:

# Add to ~/.bashrc or ~/.zshrc
source  [--image ] [--accel \|auto] ...` | Create and hatch a new VM (Defaults: min(2048MB, 50% Host RAM), 1 vCPU) | **INSERT COIN** |
| `nido start  [--gui] [--cmdline ]`     | Revive a stopped VM     | **CONTINUE? 10..9..** |
| `nido stop `                  | ACPI Shutdown signal    | **PAUSE**             |
| `nido delete `                | Destroy VM permanently  | **GAME OVER**         |
| `nido prune`                        | Delete ALL stopped VMs  | **CLEAR HIGH SCORES** |

### 🔍 Observability (HUD)

| Command              | Action                    | Arcade Analog           |
| :------------------- | :------------------------ | :---------------------- |
| `nido ls`          | List all VMs              | **PLAYER SELECT** |
| `nido info ` | Show IP, Ports, PID       | **STATS SCREEN**  |
| `nido gui`         | Interactive TUI Dashboard | **ARCADE MODE**   |
| `nido doctor`      | Diagnose system health    | **TEST MENU**     |

### 🔌 Connectivity (Link Cable)

| Command             | Action      | Arcade Analog        |
| :------------------ | :---------- | :------------------- |
| `nido ssh ` | SSH into VM | **LINK CABLE** |

### 🧬 Genetic Engineering (Images & Templates)

| Command                              | Action                    | Arcade Analog              |
| :----------------------------------- | :------------------------ | :------------------------- |
| `nido images list`                 | Browse cloud images       | **CHARACTER ROSTER** |
| `nido images pull `           | Download image            | **LOAD ROM**         |
| `nido cache ls`                    | View local cache          | **MEMORY CARD**      |
| `nido cache prune`                 | Clear unused images       | **DELETE SAVE**      |
| `nido template list`               | List custom templates     | **USER SKINS**       |
| `nido template create  ` | Save VM state as template | **SAVE STATE**       |
| `nido template delete `      | Delete template           | **ERASE**            |
| `nido blueprint list`              | Browse image recipes      | **SCHEMATICS**       |
| `nido blueprint info `       | Inspect a build recipe    | **BLUEPRINT VIEWER** |
| `nido blueprint build `      | Build VM image from recipe| **CRAFTING**         |
| `nido build `           | Compatibility alias       | **CRAFTING**         |

### ⚙️ System (Options Menu)

| Command            | Action                  | Arcade Analog               |
| :----------------- | :---------------------- | :-------------------------- |
| `nido config  [--memory MB] [--cpu N] [--accel ] [--qemu-arg "-flag"] ...` | Modify existing VM resources | **PLAYER STATS** |
| `nido config set  `  | Update global Nido settings | **OPTIONS**           |
| `nido register`  | Setup MCP integration   | **CONTROLLER CONFIG** |
| `nido update`    | Self-update from GitHub | **OTA PATCH**         |
| `nido uninstall` | Nuclear cleanup         | **SELF DESTRUCT**     |
| `nido version`   | Show version info       | **CREDITS**           |
| `nido help`      | Show usage guide        | **TUTORIAL**          |

---

## 🧬 Killer Feature: Linked Clones

Why download 2GB every time? Nido downloads the generic "Common ROM" (Base Image) **once**.

Every VM you spawn is just a **diff layer** (mutation) on top of that ROM.

- **Base Image:** Read-Only. Safe.
- **VM Disk:** Read-Write. Ephemeral.

**Result:** Spawn 100 VMs, use disk space for 1. 🚀

---

## 🤝 Contributing

**Insert Coin to Join.**

1. Fork the repo.
2. `go run ./cmd/nido gui` to test the Arcade UI.
3. Run `go run ./cmd/nido-validator` to insure your code withstands the pressure.
4. Submit a PR.
5. High Scores are recorded in `AUTHORS`.

## 📜 License

[MIT License](LICENSE). Free as in "Free Play".

---

  Made with 💜 and ☕ by digital artisans.
  EST. 2025 • "The Grid. A digital frontier."

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Josepavese](https://github.com/Josepavese)
- **Source:** [Josepavese/nido](https://github.com/Josepavese/nido)
- **License:** MIT
- **Homepage:** https://github.com/Josepavese/nido

Install and usage instructions live in the source repository linked above.