FAQ & resolução de problemas

O whispa capta o microfone ou reproduz áudio?

Não — o whispa orquestra o núcleo STT → LLM → TTS. Captar o áudio do mic e reproduzir o WAV estão fora do âmbito (usa sox/arecord/ffmpeg, ou vê o whispa-pi para um aparelho pronto).

Posso desenvolver sem whisper.cpp / Ollama / Piper instalados?

Sim. Usa os embutidos MockStt, EchoLlm, MockTts para testes e demos; troca pelos adaptadores reais quando estiveres pronto.

O WhisperCppStt falha / sem output

Garante que o whisper-cli está no PATH e o caminho do modelo está correto, e que o input é um WAV mono a 16 kHz. Passa um binary personalizado se o teu build tiver outro nome.

O OllamaLlm não liga

Confirma que o ollama serve está a correr e que o modelo foi puxado (ollama pull llama3.2). O host por defeito é http://localhost:11434; sobrepõe com a opção host.

Como adiciono outro motor (STT cloud, outro LLM)?

Implementa a interface SttEngine / LlmEngine / TtsEngine e passa-a ao VoicePipeline. O loop e o histórico mantêm-se. Ver arquitetura.

Como é gerido o histórico da conversa?

O VoicePipeline mantém um Message[] (system prompt primeiro). O maxHistory limita-o; o reset() limpa tudo exceto o system prompt.