docs: update README with model hub deployment steps and new env vars

README.md

@@ -15,25 +15,51 @@ YouTube-first backend service for AI music detection workflows.
 
 ## Hugging Face Spaces Deployment
 
-### Quick Deploy
-
-1. **Hugging Face Space Olustur**
-   - [huggingface.co/new-space](https://huggingface.co/new-space) adresine git
-   - Space Name: `crowncode-backend`
-   - SDK: **Docker** (onemli!)
-   - Hardware: **CPU Basic (Free)**
-
-2. **Dosyalari Yukle**
-   - Space sayfasinda "Files" sekmesine git
-   - "Add file" > "Upload files" tikla
-   - Su dosyalari yukle:
-     - `Dockerfile`
-     - `requirements.txt`
-     - `app/` klasoru (tum icerigi ile)
-
-3. **Deploy**
-   - "Commit changes" butonuna bas
-   - 3-5 dakika icinde build tamamlanir
+### Adım 0 — Model Dosyalarını HF Hub'a Yükle (tek seferlik)
+
+Model dosyaları `.gitignore`'da — Space'e gönderilmez. Bunun yerine container
+başlangıcında `startup.py` onları `Rtur2003/auris-models` hub reposundan indirir.
+
+```bash
+# Lokal makinede bir kere çalıştır:
+huggingface-cli login          # HF token ister (write izni gerekli)
+python upload_models_to_hub.py # ~415 MB yükler (RF 47MB + wav2vec2 360MB dahil)
+```
+
+Upload sonrası `https://huggingface.co/Rtur2003/auris-models` adresinde
+tüm model dosyaları görünmeli.
+
+### Adım 1 — Space Oluştur
+
+- [huggingface.co/new-space](https://huggingface.co/new-space) adresine git
+- Space Name: `crowncode-backend`
+- SDK: **Docker** (önemli!)
+- Hardware: **CPU Basic (Free)**
+
+### Adım 2 — Kodu Push Et
+
+```bash
+cd hf-crowncode-backend
+git remote add space https://huggingface.co/spaces/Rtur2003/crowncode-backend
+git push space main
+```
+
+Veya Space sayfasında "Files" > "Add file" ile `Dockerfile`, `requirements.txt`,
+`startup.py`, `app/` klasörünü yükle.
+
+### Adım 3 — HF_TOKEN Secret Ekle (isteğe bağlı)
+
+Eğer `auris-models` reposu **private** ise:
+
+- Space > Settings > Repository secrets
+- `HF_TOKEN` = HuggingFace read token
+
+### Adım 4 — Deploy
+
+- "Commit changes" butonuna bas
+- Build ~5-8 dk sürer (PyTorch + model download)
+- `startup.py` tüm model dosyalarını `/app/models/` altına indirir
+- API ayağa kalkar, "Önizleme Modu" biter
 
 ### URL Format
 ```
@@ -135,6 +161,10 @@ Response:
 
 | Variable | Default | Description |
 |----------|---------|-------------|
+| `AURIS_MODELS_REPO` | `Rtur2003/auris-models` | HuggingFace model repo to download artifacts from at startup |
+| `MODELS_DIR` | `/app/models` | Local directory where model files are stored |
+| `HF_TOKEN` | - | HuggingFace token (required if `auris-models` repo is private) |
+| `SKIP_MODEL_DOWNLOAD` | `0` | Set to `1` to skip startup download (local dev with models already present) |
 | `CROWNCODE_CORS_ORIGINS` | `http://localhost:3000` | Allowed CORS origins (comma-separated). **Do not use `*` in production.** |
 | `MUSIC_AI_API_URL` | - | Music-AIDetector service URL |
 | `SES_ANALIZI_API_URL` | - | Ses-Analizi service URL |