# Install

## Requirements

- Linux x86_64 host
- Python 3.12+
- `/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
```

Run one command in a curated environment:

```bash
uvx --from pyro-mcp pyro run debian:12 --vcpu-count 1 --mem-mib 1024 -- git --version
```

Inspect the official environment catalog:

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

## Installed CLI

```bash
uv tool install .
pyro --version
pyro env list
pyro doctor
```

## Contributor Clone

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