smallwhisper/README.md

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

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Avvio

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.