| # 🚀 Guida al Deployment su Hugging Face Spaces | |
| ## 1. Creazione dello Space | |
| 1. Vai su [Hugging Face Spaces](https://huggingface.co/spaces) | |
| 2. Clicca su "Create new Space" | |
| 3. Scegli un nome per il tuo Space (es. `scribeaid-demo`) | |
| 4. Seleziona **Gradio** come SDK | |
| 5. Scegli **Public** o **Private** in base alle tue esigenze | |
| 6. Clicca su "Create Space" | |
| ## 2. Upload dei File | |
| Carica tutti i file di questa cartella nello Space: | |
| ``` | |
| scribeaid-demo/ | |
| ├── app.py # ✅ File principale dell'app | |
| ├── requirements.txt # ✅ Dipendenze Python | |
| ├── README.md # ✅ Metadata e descrizione | |
| ├── .gitignore # ✅ File da ignorare | |
| └── assets/ | |
| └── ScribeAId.svg # ✅ Logo dell'app | |
| ``` | |
| **IMPORTANTE**: NON caricare la cartella `content/` che contiene i modelli - questi verranno scaricati automaticamente da Hugging Face Hub. | |
| ## 3. Configurazione dei Secrets | |
| Nel tuo Space, vai su **Settings** → **Variables and secrets** e aggiungi: | |
| ### Secrets Obbligatori: | |
| ``` | |
| HF_MODEL_ID = "ReportAId/whisper-medium-it-finetuned" | |
| BASE_WHISPER_MODEL_ID = "openai/whisper-medium" | |
| ``` | |
| ### Secrets Opzionali (se necessari): | |
| ``` | |
| HF_TOKEN = "hf_xxxxxxxxxxxxxxxxxxxxxxxxxx" | |
| HUGGINGFACEHUB_API_TOKEN = "hf_xxxxxxxxxxxxxxxxxxxxxxxxxx" | |
| ``` | |
| **Nota**: Il token HF è necessario solo se i tuoi modelli sono privati. | |
| ## 4. Configurazione Hardware | |
| Per prestazioni ottimali, vai su **Settings** → **Hardware** e seleziona: | |
| - **CPU basic** (gratuito) - per test | |
| - **CPU upgrade** - per uso moderato | |
| - **T4 small** - per prestazioni migliori (richiede abbonamento) | |
| ## 5. Deploy e Test | |
| 1. Dopo aver caricato i file e configurato i secrets, lo Space si avvierà automaticamente | |
| 2. Controlla i **Logs** per eventuali errori | |
| 3. Una volta avviato, testa l'app caricando un file audio | |
| ## 6. Risoluzione Problemi Comuni | |
| ### Errore "Model not found" | |
| - Verifica che `HF_MODEL_ID` e `BASE_WHISPER_MODEL_ID` siano corretti | |
| - Se il modello è privato, assicurati che `HF_TOKEN` sia configurato | |
| ### Errore "Out of memory" | |
| - Prova con un hardware più potente | |
| - L'app è ottimizzata per funzionare anche su CPU | |
| ### Errore "Audio processing failed" | |
| - Verifica che il file audio sia in un formato supportato (WAV, MP3, etc.) | |
| - L'audio deve essere di almeno 5-10 secondi per risultati ottimali | |
| ## 7. Monitoraggio | |
| - Controlla regolarmente i **Logs** dello Space | |
| - Monitora l'utilizzo delle risorse in **Settings** → **Usage** | |
| ## 8. Aggiornamenti | |
| Per aggiornare l'app: | |
| 1. Modifica i file localmente | |
| 2. Carica i file aggiornati nello Space | |
| 3. Lo Space si riavvierà automaticamente | |
| --- | |
| 🎯 **Il tuo Space sarà disponibile all'indirizzo**: `https://huggingface.co/spaces/TUO_USERNAME/NOME_SPACE` | |