README.md

---
title: Virtual Try-On (CatVTON)
emoji: 👗
colorFrom: pink
colorTo: purple
sdk: gradio
sdk_version: "5.20.0"
app_file: app.py
pinned: false
license: apache-2.0
hardware: zero-a10g
---

# 👗 Virtual Try-On

Try on garments virtually using AI — runs entirely in your browser via Hugging Face ZeroGPU.

**No local GPU or storage needed.**

## How to Use

1. Upload a **person photo** (front-facing works best)
2. Upload a **garment image** (product photo on white background works best)
3. Select the garment type (upper / lower / overall)
4. Click **Try On**
5. Download the result to your device

## Technical Details

- **Model**: [CatVTON](https://github.com/zhengchong/CatVTON) (`zhengchong/CatVTON`)
- **GPU**: Hugging Face ZeroGPU (A10G, free tier)
- **Model storage**: Downloaded once to `/data` persistent storage on HF servers
- **Your device**: Only needs a web browser — no downloads, no GPU

## Notes

- First run takes ~2-5 minutes (model download to HF servers)
- Subsequent runs start immediately (model cached in persistent storage)
- For best results: clear front-facing photos, garment on white/neutral background
- ZeroGPU provides ~120 seconds of GPU time per generation

## Built With

- [CatVTON](https://github.com/zhengchong/CatVTON) — virtual try-on model
- [Gradio](https://gradio.app) — web interface
- [Hugging Face ZeroGPU](https://huggingface.co/docs/hub/spaces-zerogpu) — free GPU