pixelrag
Installation
SKILL.md
PixelRAG operator
Instructions
- Check the source pin. From jeo-skills root use
python3 .agent-skills/pixelrag/scripts/preflight.py --repo /absolute/upstream --json; from the installed skill root usescripts/preflight.py. No--repois inventory only. Hashes cover selected source files, not Git HEAD, the full tree, package installation, model downloads, or runtime. Read pinned source notes. - Choose local or hosted retrieval explicitly. PixelRAG renders visual documents/pages to image tiles, embeds visual content, builds a search index, and can serve queries. The upstream README also documents a hosted API and a prebuilt multi-terabyte index download. Do not switch to either external surface by implication; confirm data transfer, provider, cost, account, and destination.
- Map the local pipeline. Separate
pixelshotcapture frompixelragstages (chunk,embed,build-index,index,serve). Inspectpixelrag.yaml, source connector, embedding model/device, output/index directory, and server bind before proceeding. PixelRAG is multimodal visual retrieval, not a knowledge graph/ontology. - Get approval before effects. Ask before installing extras/native packages; downloading model weights or datasets; capturing private/third-party URLs; sending content or queries to hosted APIs or paid providers; writing/rebuilding/deleting tiles, embeddings, indexes or target data; or starting a service/public bind. Do not put credentials in CLI arguments or reports.
- Verify by stage. After approval, inspect
pixelrag <stage> --help, run a small authorized sample, verify rendered tiles and their source mapping, index output, and query results. Preflight is offline provenance only; it is not a successful render, model load, index build, API deployment, or search test.
Examples
# Provenance check only; absolute, non-symlink checkout.
python3 .agent-skills/pixelrag/scripts/preflight.py --repo /work/PixelRAG --json