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

Document Git LFS runtime bundle workflow

Browse source
This commit is contained in:
Thales Maciel 2026-03-07 17:14:52 -03:00
parent 1b19bff7b6
commit 227983a877
3 changed files with 36 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

4
AGENTS.md
View file

@ -9,10 +9,12 @@ This repository ships `pyro-mcp`, an MCP-compatible package for ephemeral VM lif
## Development Workflow
- Use `uv` for all Python environment and command execution.
- Install Git LFS before cloning or materializing the packaged runtime bundle: `git lfs install`.
- Run `make setup` after cloning.
- Run `make check` before opening a PR.
- Public user-facing CLI is `pyro`.
- Public Python SDK entrypoint is `from pyro_mcp import Pyro`.
- The packaged runtime images under `src/pyro_mcp/runtime_bundle/` are stored in Git LFS.
- Use `make runtime-bundle` to regenerate the packaged runtime bundle from `runtime_sources/`.
- Use `make runtime-materialize` to build real runtime inputs into `build/runtime_sources/`.
- Use `make runtime-fetch-binaries`, `make runtime-build-kernel-real`, and `make runtime-build-rootfs-real` if you need to debug the real-source pipeline step by step.
@ -24,6 +26,8 @@ This repository ships `pyro-mcp`, an MCP-compatible package for ephemeral VM lif
- Use `make doctor` to inspect bundled runtime integrity and host prerequisites.
- Network-enabled flows require host privilege for TAP/NAT setup; the current implementation uses `sudo -n` for `ip`, `nft`, and `iptables` when available.
- If you need full log payloads from the Ollama demo, use `make ollama-demo OLLAMA_DEMO_FLAGS=-v`.
- After heavy runtime work, reclaim local space with `rm -rf build` and `git lfs prune`.
- The pre-migration `pre-lfs-*` tag is local backup material only; do not push it or it will keep the old giant blobs reachable.
## Quality Gates