DEPLOYMENT_GUIDE.md

🚀 Guida al Deployment su Hugging Face Spaces

1. Creazione dello Space

1. Vai su Hugging Face 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