Problemi con i modelli

I modelli locali vengono scaricati da Hugging Face e restano nella cartella dati dell'applicazione Speakly. Si gestiscono in Settings → Transcription (Impostazioni → Trascrizione), sotto Local Model (On-Device).

Dove sono i modelli

macOS: ~/Library/Application Support/Speakly/whisper-models
Windows: %APPDATA%\Speakly\whisper-models

Un file .bin per modello — per esempio ggml-large-v3-turbo-q8_0.bin. Un download in corso viene scritto con lo stesso nome più .tmp e rinominato solo al termine, così un modello scaricato a metà non può essere confuso con uno completo.

Il download è fallito

Speakly mostra Download failed. Please try again. ed elimina il proprio file .tmp. Per riprovare:

Verifica di essere online e di avere spazio su disco — i file large-v3 arrivano a diversi gigabyte.
Apri Settings → Transcription e clicca di nuovo Download su quel modello.
Se nella cartella sopra è rimasto un file *.bin.tmp — possibile dopo un crash o una chiusura forzata — eliminalo e riavvia il download.
Se il modello è contrassegnato Downloaded ma continua a fallire, clicca l'icona del cestino, conferma Delete Model? e scaricalo di nuovo.

Annullare è sicuro

Cliccare Cancel durante un download lo interrompe e rimuove il file parziale. Niente resta scritto a metà con il nome reale del modello, quindi il Download successivo parte pulito.

Cosa significano i messaggi di errore

Model not found, nella pillola di registrazione — whisper.cpp non ha potuto inizializzare il file del modello. Elimina il modello in Settings → Transcription e scaricalo di nuovo.
Local transcription failed, nella pillola di registrazione — qualsiasi altro errore locale, incluso il caso di modello mancante il cui testo completo è Model "large-v3-turbo-q8_0" is not downloaded. Please download it in Settings > Transcription.
Local transcription returned empty text — il modello ha girato ma non ha sentito nulla. Controlla il dispositivo di ingresso in Settings → General → Microphone.
Model <name> is already being downloaded — è stato chiesto un secondo download dello stesso modello; attendi il primo.
Failed to load model information — Speakly non ha potuto leggere la cartella dei modelli sopra.
Failed to delete model — il file .bin non è stato rimosso. Chiudi Speakly, elimina il file a mano e riapri.

Il modello è lento

Scegli un modello più piccolo in Settings → Transcription — large-v3-turbo-q5_0 è l'opzione più leggera.
Su un Mac con Metal, Settings → Transcription mostra Apple Metal detected! Local transcription will be 3x faster on your device. con una casella Enable — lasciala spuntata.
L'interruttore Audio acceleration in Settings → System qui non aiuta — vale solo per i motori API; il modello locale trascrive sempre l'audio originale.
Se la macchina è semplicemente lenta, passa a un provider BYOK in Settings → Transcription — così l'audio è trascritto dal provider e non dalla tua CPU.