DEPLOYMENT_GUIDE.md

# 🚀 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`