Upload README.md with huggingface_hub

README.md

@@ -1,10 +1,29 @@
 ---
-title: Text2sql Demo
-emoji: 🌍
-colorFrom: gray
-colorTo: purple
+title: Text to SQL Demo
+emoji: 🔍
+colorFrom: blue
+colorTo: indigo
 sdk: docker
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Text-to-SQL Demo
+
+Fine-tuned T5-base / CodeT5-base / BART-base on WikiSQL → Spider → BIRD (curriculum learning).
+
+**12 checkpoints** across 4 training stages × 3 architectures — selectable via dropdown.
+
+## Setup (if self-hosting)
+
+```bash
+pip install torch --index-url https://download.pytorch.org/whl/cpu
+pip install -r requirements.txt
+uvicorn src.app.api:app --host 0.0.0.0 --port 8000
+```
+
+Then open `http://localhost:8000`.
+
+## HF Space secrets
+
+If the model repos are private, add `HF_TOKEN` as a Space secret
+(Settings → Variables and secrets → New secret).