Problemas com Modelos

Os modelos locais são baixados do Hugging Face e ficam na pasta de dados do aplicativo Speakly. Você os gerencia em Settings → Transcription (Configurações → Transcrição), em Local Model (On-Device).

Onde os modelos ficam

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

Um arquivo .bin por modelo — por exemplo ggml-large-v3-turbo-q8_0.bin. Um download em andamento é gravado com esse mesmo nome mais .tmp e só é renomeado quando termina, então um modelo baixado pela metade nunca é confundido com um completo.

O download falhou

O Speakly mostra Download failed. Please try again. e apaga o próprio arquivo .tmp. Para tentar de novo:

Confirme que você está online e tem espaço em disco — os arquivos large-v3 chegam a gigabytes.
Abra Settings → Transcription e clique em Download no modelo novamente.
Se sobrou algum arquivo *.bin.tmp na pasta acima — possível depois de um travamento ou de um encerramento forçado — apague-o e baixe de novo.
Se o modelo aparece como Downloaded mas ainda falha, clique no ícone de lixeira, confirme em Delete Model? e baixe outra vez.

Cancelar é seguro

Clicar em Cancel durante um download interrompe e remove o arquivo parcial. Nada fica gravado pela metade com o nome real do modelo, então o próximo Download começa limpo.

O que as mensagens de erro significam

Model not found, na pílula de gravação — o whisper.cpp não conseguiu inicializar o arquivo do modelo. Apague o modelo em Settings → Transcription e baixe novamente.
Local transcription failed, na pílula de gravação — qualquer outra falha local, incluindo o caso de modelo ausente, cujo texto completo é Model "large-v3-turbo-q8_0" is not downloaded. Please download it in Settings > Transcription.
Local transcription returned empty text — o modelo rodou mas não ouviu nada. Verifique o dispositivo de entrada em Settings → General → Microphone.
Model <name> is already being downloaded — um segundo download do mesmo modelo foi solicitado; espere o primeiro terminar.
Failed to load model information — o Speakly não conseguiu ler a pasta de modelos acima.
Failed to delete model — o arquivo .bin não pôde ser removido. Feche o Speakly, apague o arquivo manualmente e abra de novo.

O modelo está lento

Escolha um modelo menor em Settings → Transcription — o large-v3-turbo-q5_0 é a opção mais leve.
Em um Mac com Metal, Settings → Transcription mostra Apple Metal detected! Local transcription will be 3x faster on your device. com uma caixa Enable — deixe marcada.
O controle Audio acceleration em Settings → System não ajuda aqui — ele só vale para motores de API; o modelo local sempre transcreve o áudio original.
Se a máquina simplesmente é lenta, troque para um provedor BYOK em Settings → Transcription — aí o áudio é transcrito pelo provedor, não pela sua CPU.