Add adoption-focused examples, contract docs, and CLI polish

docs/install.md

@@ -0,0 +1,46 @@
+# Install
+
+## Requirements
+
+- Linux host
+- Python 3.12+
+- Git LFS
+- `/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 sandbox:
+
+```bash
+uvx --from pyro-mcp pyro run --profile debian-git --vcpu-count 1 --mem-mib 1024 -- git --version
+```
+
+## Installed CLI
+
+```bash
+uv tool install .
+pyro --version
+pyro doctor
+```
+
+## Contributor Clone
+
+```bash
+git lfs install
+git clone <repo>
+cd pyro
+git lfs pull
+make setup
+```