thaloco/pyro-mcp
1
Fork 0
Code Pull requests Releases Packages Activity Actions

Clarify package install and run expectations

Browse source
This commit is contained in:
Thales Maciel 2026-03-09 21:36:36 -03:00
parent b2ea56db4c
commit be654b5b41
6 changed files with 76 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

12
docs/first-run.md
View file

@ -2,6 +2,8 @@
This is the intended evaluator path for a first successful run on a supported host.
Copy the commands as-is. Paths and timing values will differ on your machine.
If you are running from a source checkout instead of the published package, replace
`uvx --from pyro-mcp pyro` with `uv run pyro`.
## 1. Verify the host
@ -27,6 +29,10 @@ debian:12-build [installed|not installed] Debian 12 environment with Git and com
## 3. Pull the default environment
The first pull downloads an OCI environment from public Docker Hub, requires outbound HTTPS
access to `registry-1.docker.io`, and needs local cache space for the guest image. See
[host-requirements.md](host-requirements.md) for the full host requirements.
```bash
$ uvx --from pyro-mcp pyro env pull debian:12
Pulled: debian:12
@ -46,10 +52,14 @@ OCI source: registry-1.docker.io/thalesmaciel/pyro-environment-debian-12:1.0.0
```bash
$ uvx --from pyro-mcp pyro run debian:12 -- git --version
git version ...
[run] environment=debian:12 execution_mode=guest_vsock exit_code=0 duration_ms=...
git version ...
```
The guest command output and the `[run] ...` summary are written to different streams, so they
may appear in either order in terminals or capture tools. Use `--json` if you need a
deterministic structured result.
## 5. Optional next steps
```bash