pyro-mcp/docs/install.md

1.1 KiB

Install

Requirements

  • Linux x86_64 host
  • Python 3.12+
  • uv
  • /dev/kvm

If you want outbound guest networking:

  • ip
  • nft or iptables
  • privilege to create TAP devices and configure NAT

Fastest Start

Run the MCP server directly from the package without a manual install:

uvx --from pyro-mcp pyro mcp serve

Prefetch the default official environment:

uvx --from pyro-mcp pyro env pull debian:12

Run one command in a curated environment:

uvx --from pyro-mcp pyro run debian:12 -- git --version

Inspect the official environment catalog:

uvx --from pyro-mcp pyro env list

Installed CLI

uv tool install pyro-mcp
pyro --version
pyro env list
pyro env pull debian:12
pyro env inspect debian:12
pyro doctor
pyro run debian:12 -- git --version

pyro run defaults to 1 vCPU / 1024 MiB. If guest execution is unavailable, the command fails unless you explicitly pass --allow-host-compat.

Contributor Clone

git lfs install
git clone <repo>
cd pyro
git lfs pull
make setup