Initial commit: SmallWhisper - web app per trascrizione audio con faster-whisper

README.md

@@ -0,0 +1,35 @@
+# SmallWhisper
+
+Web app per trascrizione audio in italiano usando **faster-whisper**.
+
+Carica un file audio (`.m4a`, `.mp3`, `.wav`, `.ogg`, ecc.) e ottieni la trascrizione in formato testo — tutto in locale, senza chiamate a servizi esterni.
+
+## Requisiti
+
+- Python 3.10+
+- ffmpeg (`apt install ffmpeg` su Debian/Ubuntu)
+- ~2 GB di spazio per il modello Whisper
+
+## Installazione
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+```
+
+## Avvio
+
+```bash
+source .venv/bin/activate
+export HF_TOKEN=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
+python app.py
+```
+
+Apri il browser su `http://localhost:5000`.
+
+### Note
+
+- Il modello Whisper `small` (~1.5 GB) viene scaricato automaticamente al primo avvio.
+- La prima trascrizione potrebbe essere più lenta, poi il modello resta in cache.
+- Supporta qualsiasi formato audio gestito da ffmpeg.