README.md

metadata

title: Soul Threading v12 Primeo-Fused
emoji: 🧵
colorFrom: purple
colorTo: blue
sdk: gradio
app_file: app.py
pinned: false
license: mit

Soul Threading v12 Primeo-Fused

One-platform Hugging Face / ZeroGPU-ready AOP garment mapper.

This version fuses the best parts of Primeo's pipeline design into the v11 production mapper.

What it does

1. Upload artwork.
2. Upload AOP template ZIP.
3. Scan only white printable areas from template PNGs.
4. Build multiple divergent layout candidates.
5. Score them through a Quality Tribunal.
6. Render clean transparent print PNGs.
7. Enforce pocket/flap/overlay continuity.
8. Export a production ZIP.

Locked rules

Only white printable template areas become pieces.
Colored seam / bleed / blur / safe lines are restrictions, never pieces.
Front body receives the hero by default.
Back, hood, sleeves, trim, labels receive support crops.
Pocket/flap/overlay inherits rendered front underlay.
No production guide lines appear in exported PNGs.

Files

app.py
requirements.txt
README.md
memory/
docs/
tests/
deploy_to_hf.ps1

ZeroGPU

The pipeline is decorated with @spaces.GPU, which keeps it ready for ZeroGPU model upgrades. The current v12 core remains CPU-safe and deterministic for production export.

Future model slots can be added inside this same Space:

Grounding DINO
SAM/SAM2
Florence OCR
VLM art director