Problèmes de modèles

Les modèles locaux sont téléchargés depuis Hugging Face et conservés dans le dossier de données applicatives de Speakly. Vous les gérez dans Settings → Transcription (Réglages → Transcription), sous Local Model (On-Device).

Où sont stockés les modèles

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

Un fichier .bin par modèle — par exemple ggml-large-v3-turbo-q8_0.bin. Un téléchargement en cours est écrit sous ce même nom suivi de .tmp et n'est renommé qu'à la fin, de sorte qu'un modèle à moitié téléchargé ne peut jamais être pris pour un modèle complet.

Le téléchargement a échoué

Speakly affiche Download failed. Please try again. et supprime son propre fichier .tmp. Pour réessayer :

Vérifiez votre connexion et l'espace disque — les fichiers large-v3 pèsent plusieurs gigaoctets.
Ouvrez Settings → Transcription et cliquez de nouveau sur Download pour ce modèle.
S'il reste un fichier *.bin.tmp dans le dossier ci-dessus — possible après un plantage ou une fermeture forcée — supprimez-le puis relancez le téléchargement.
Si le modèle porte la mention Downloaded mais échoue quand même, cliquez sur son icône de corbeille, confirmez Delete Model?, et téléchargez-le à nouveau.

Annuler est sans risque

Cliquer sur Cancel pendant un téléchargement l'interrompt et supprime le fichier partiel. Rien ne reste écrit à moitié sous le vrai nom du modèle, donc le Download suivant repart proprement.

Ce que signifient les messages d'erreur

Model not found, dans la pilule d'enregistrement — whisper.cpp n'a pas pu initialiser le fichier du modèle. Supprimez le modèle dans Settings → Transcription et retéléchargez-le.
Local transcription failed, dans la pilule d'enregistrement — toute autre défaillance locale, y compris le cas du modèle absent dont le texte complet est Model "large-v3-turbo-q8_0" is not downloaded. Please download it in Settings > Transcription.
Local transcription returned empty text — le modèle a tourné mais n'a rien entendu. Vérifiez le périphérique d'entrée dans Settings → General → Microphone.
Model <name> is already being downloaded — un second téléchargement du même modèle a été demandé ; attendez la fin du premier.
Failed to load model information — Speakly n'a pas pu lire le dossier des modèles ci-dessus.
Failed to delete model — le fichier .bin n'a pas pu être supprimé. Quittez Speakly, supprimez le fichier à la main, puis relancez.

Le modèle est lent

Choisissez un modèle plus petit dans Settings → Transcription — large-v3-turbo-q5_0 est l'option la plus légère.
Sur un Mac avec Metal, Settings → Transcription affiche Apple Metal detected! Local transcription will be 3x faster on your device. avec une case Enable — laissez-la cochée.
Le réglage Audio acceleration dans Settings → System n'aide pas ici — il ne s'applique qu'aux moteurs API ; le modèle local transcrit toujours l'audio d'origine.
Si la machine est simplement trop lente, passez à un fournisseur BYOK dans Settings → Transcription — l'audio est alors transcrit par le fournisseur et non par votre processeur.