---
title: SigLIP Text→Image Retrieval (H&M Fashion)
emoji: 🔎
colorFrom: pink
colorTo: indigo
sdk: gradio
sdk_version: "5.42.0"
app_file: app.py
pinned: false
---

# Text → Image Retrieval (SigLIP + FAISS)

Demo truy hồi ảnh theo văn bản dùng **SigLIP** + **FAISS** trên dataset `tomytjandra/h-and-m-fashion-caption`.  
Hỗ trợ CPU mặc định (faiss-cpu) và tự dùng FAISS‑GPU nếu phần cứng có sẵn.

## Cách chạy trên Spaces
1. **Upload checkpoint SigLIP** vào repo (ví dụ: `./siglip_checkpoint/`).
2. Vào **Settings → Variables and secrets**:
   - `SIGLIP_CHECKPOINT_DIR=./siglip_checkpoint`
   - (tuỳ chọn) `INDEX_DIR=./index_cache`
3. Chọn **SDK = Gradio** (đã khai báo ở trên) và phần cứng:
   - CPU basic (miễn phí) hoặc GPU nếu muốn build/search nhanh hơn.
4. Nhấn **Run**. Lần đầu sẽ build index và cache vào `INDEX_DIR`.

## Chạy local
```bash
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
export SIGLIP_CHECKPOINT_DIR=./siglip_checkpoint
python app.py