SKILL.md
Pixel Detective Exports
Generate standalone exports (no UI) and manage collections for Pixel Detective.
Requirements
- Ingestion API running on
http://localhost:8002 - Qdrant running (Docker)
- GPU UMAP service on
http://localhost:8003for HDBSCAN clustering - Optional (for visuals):
matplotlib - Optional (for PDF output):
weasyprint(preferred) orplaywright
Quickstart
- UMAP + HDBSCAN JSON/CSV/SVG:
python skills/pixel-detective-exports/scripts/exportumaphdbscan.py --collection <name> - Cluster report PDF/HTML (all collections):
python skills/pixel-detective-exports/scripts/exportumappdf.py --sample-size 500
Exports
UMAP + HDBSCAN export (standalone)
- Script:
python skills/pixel-detective-exports/scripts/exportumaphdbscan.py - Output default:
exports/pixel-detective/umap/umaphdbscan<collection>.json|csv|svg - Example:
- python skills/pixel-detective-exports/scripts/exportumaphdbscan.py --collection my_collection --sample-size 2000 - Color controls: --color-map tab20 --point-size 18 --outlier-size 12 --outlier-color #94a3b8
UMAP PDF report (all collections)
- Script:
python skills/pixel-detective-exports/scripts/exportumappdf.py - Output default:
exports/pixel-detective/umap/umapclusterreport.pdf - Example:
- python skills/pixel-detective-exports/scripts/exportumappdf.py --sample-size 500 --title "Pixel Detective UMAP Clusters"
Collection management
Manage collections via API (Qdrant in Docker)
- Script:
python skills/pixel-detective-exports/scripts/manage_collections.py - Examples:
- List: python skills/pixel-detective-exports/scripts/managecollections.py --action list - Info: python skills/pixel-detective-exports/scripts/managecollections.py --action info --collection mycollection - Create: python skills/pixel-detective-exports/scripts/managecollections.py --action create --collection mycollection --vector-size 512 --distance Cosine - Select: python skills/pixel-detective-exports/scripts/managecollections.py --action select --collection mycollection - Delete: python skills/pixel-detective-exports/scripts/managecollections.py --action delete --collection mycollection - Merge: python skills/pixel-detective-exports/scripts/managecollections.py --action merge --dest mergedcollection --sources a,b,c - Qdrant fallback listing: python skills/pixel-detective-exports/scripts/managecollections.py --action list --qdrant http://localhost:6333
Notes
- HDBSCAN clustering is performed by the GPU UMAP service; the ingestion service does not offer HDBSCAN.
- Collection operations go through the ingestion API, which talks to Qdrant in Docker.
- Use the start skill to bring up services:
- powershell -ExecutionPolicy Bypass -File skills\\start-pixel-detective\\scripts\\startpixeldetective.ps1 -Mode backend -UseGpuUmap