FAQ & resolução de problemas

Que Raspberry Pi preciso?

Um Pi 5 (8 GB) é ideal; um Pi 4 (4 GB+) funciona mas o LLM é mais lento. Usa cooler ativo e a fonte oficial — a subtensão faz throttle à inferência. Ver hardware.

Sem áudio de entrada ou saída

Lista os dispositivos com arecord -l / aplay -l, define device (ex.: plughw:1,0) na config, e testa: arecord -d 3 -f S16_LE -r 16000 -c 1 t.wav && aplay t.wav.

Nunca pára de gravar (VAD do sox)

A VAD pára após ~1.5 s de silêncio por defeito. Sobe o threshold ou reduz o ruído ambiente; ou muda para o gravador arecord de duração fixa.

As respostas são demasiado lentas

Usa um LLM mais pequeno (llama3.2:1b) e um modelo whisper mais pequeno (tiny.en/base.en). Num Pi, a latência é dominada pelo LLM.

Corre mesmo offline?

Sim — depois de instalados o whisper.cpp, um modelo Ollama e uma voz Piper, não é preciso rede. O momento digno de demo é desligar a rede e voltar a perguntar.

Como corro no arranque / vejo logs?

Instala o unit systemd (systemd/whispa-pi.service), sudo systemctl enable --now whispa-pi, e observa journalctl -u whispa-pi -f.

Posso adicionar uma wake word ou um botão?

Sim — aciona o appliance.runOnce() a partir do openWakeWord ou de um botão GPIO. Ver melhorias.