README.md

---
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

```txt
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

```txt
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:

```txt
Grounding DINO
SAM/SAM2
Florence OCR
VLM art director
```