Solución de problemas

room-assistant no existe

Activa el entorno virtual:

source .venv/bin/activate

Si sigue fallando:

pip install -e .

El modo voz no arranca

Revisa estas cosas:

• VOSK_MODEL_PATH existe
• instalaste el proyecto con pip install -e .
• el entorno virtual está activo

No aparece el micrófono

room-assistant list-microphones

Si no aparece, reconecta el USB y prueba otra vez.

La wake word no funciona bien

• revisa ROOM_ASSISTANT_WAKE_WORD
• prueba primero room-assistant simulate
• si usas Porcupine, revisa su access key y el archivo .ppn

No habla

• revisa ROOM_ASSISTANT_TTS_BACKEND
• asegúrate de que mpv esté instalado

La música no suena

• revisa NAVIDROME_URL, NAVIDROME_USERNAME y NAVIDROME_PASSWORD
• asegúrate de que mpv existe en PATH

Home Assistant falla

• revisa HOME_ASSISTANT_URL
• revisa HOME_ASSISTANT_TOKEN
• un 401 suele ser token incorrecto
• un 404 suele ser entidad o servicio no encontrado

Comprobaciones rápidas

python -m compileall room_assistant
python -c "import room_assistant"
room-assistant simulate