# 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:

```bash
uvx --from pyro-mcp pyro mcp serve
```

Prefetch the default official environment:

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

Run one command in a curated environment:

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

Inspect the official environment catalog:

```bash
uvx --from pyro-mcp pyro env list
```

## Installed CLI

```bash
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

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