pyro-mcp/docs/troubleshooting.md

Troubleshooting

pyro doctor reports runtime checksum mismatch

Cause:

• the Git LFS pointer files are present, but the real runtime images have not been checked out

Fix:

git lfs pull
git lfs checkout
pyro doctor

pyro run --network fails before the guest starts

Cause:

• the host cannot create TAP devices or NAT rules

Fix:

pyro doctor

Then verify:

• ip
• nft or iptables
• /dev/net/tun
• host privilege for sudo -n

Ollama demo exits with tool-call failures

Cause:

• the model produced an invalid tool call or your Ollama model is not reliable enough for tool use

Fix:

pyro demo ollama -v

Inspect:

• model output
• requested tool calls
• tool results

Repository clone is still huge after the LFS migration

Cause:

• old refs are still present locally
• build/ or .venv/ duplicates are consuming disk

Fix:

rm -rf build
git lfs prune

If needed, recreate .venv/.