Preparare whisper.cpp e verificare il modello
Preparare whisper.cpp e verificare il modello — Trascrizione locale gratuita con Whisper e FFmpeg. Una cartella riproducibile per lo strumento; I pesi non sono l’eseguibile; Una verifica d’avvio senza confondere i percorsi. Esercitazione pratica: Preparare whisper.cpp e verificare il modello.
Versione demo. I materiali sono in fase di revisione editoriale.
Argomenti trattati
- Una cartella riproducibile per lo strumento
- I pesi non sono l’eseguibile
- Una verifica d’avvio senza confondere i percorsi
Una cartella riproducibile per lo strumento
L’esempio usa una shell Linux o macOS con Git, CMake, compilatore C++ e FFmpeg. Su Windows percorsi ed esecuzione possono differire: consulta le istruzioni ufficiali della piattaforma. Questi comandi sono materiale didattico, non operazioni già eseguite. Crea asr-lab con whisper.cpp separata per non mescolare sorgenti e registrazioni. CMake configura build, poi il compilatore produce whisper-cli. Se cmake manca, correggi il prerequisito: aggiungere sudo casualmente non installa il compilatore e crea privilegi superflui. Se la compilazione fallisce, leggi il primo errore significativo, non soltanto «build failed». Registra commit Git e versione CMake in toolchain.txt per distinguere cambiamenti software e audio. Conserva una compilazione funzionante quando provi aggiornamenti.
mkdir asr-lab
cd asr-lab
mkdir originals work reviewed
git clone https://github.com/ggml-org/whisper.cpp.git
cmake -S whisper.cpp -B whisper.cpp/build
cmake --build whisper.cpp/build -j 2 --config Release
git -C whisper.cpp rev-parse HEAD
I pesi non sono l’eseguibile
whisper-cli richiede pesi in un formato supportato da whisper.cpp. Una cartella di pesi Python non diventa automaticamente un modello ggml. Usa lo script ufficiale per base dalla directory whisper.cpp. La subshell torna ad asr-lab, quindi i percorsi successivi ripartono dalla radice del progetto. Attendi whisper.cpp/models/ggml-base.bin; l’esistenza non prova un download completo. Verifica messaggi, dimensione e checksum della fonte quando disponibile. Una pagina HTML d’errore salvata come .bin non è un modello. Non sostituire pesi con eseguibili sconosciuti «accelerati». Registra nome, fonte, data e hash della copia. L’hash aiuta la riproducibilità ma non autentica l’origine se il riferimento non è verificato. Correggi un caso locale prima di avviare elaborazioni in serie.
(cd whisper.cpp && sh ./models/download-ggml-model.sh base)
./whisper.cpp/build/bin/whisper-cli -h
Una verifica d’avvio senza confondere i percorsi
Il comando -h deve mostrare opzioni dell’eseguibile realmente compilato. Salva help accanto a toolchain.txt: versioni diverse cambiano formati e opzioni. Il percorso base usa WAV PCM a 16 bit anche quando la compilazione legge MP3, rendendo controllabile la preparazione. Se la shell dice «No such file», verifica cartella corrente e build/bin invece di scaricare ancora i pesi. Se il programma parte ma non carica il modello, controlla -m. Per errori GPU consulta help per una modalità CPU supportata: è diagnosi, non garanzia di velocità. Non esporre un server modello in rete per trascrivere file. Qui non servono porte, chiavi API o account esterni. Verifica eseguibile, modello e ingresso separatamente: problemi diversi possono sembrare simili.
Esercitazione pratica
Preparare whisper.cpp e verificare il modello
Vai alla lezione