Configuración
Las variables importantes para arrancar el proyecto sin liarte.
Room Assistant lee variables de entorno o un archivo .env.
Mínimo para usarlo
Se puede usar cualquier modelo de IA. En este caso, vamos a usar Gemma 4 de Google, que es abierto y relativamente rápido.
OPENAI_API_KEY="tu-api-key"
OPENAI_MODEL="google/gemma-4-31b-it"
OPENAI_BASE_URL="https://openrouter.ai/api/v1"
ROOM_ASSISTANT_WAKE_WORD="oye room"Con eso ya puedes usar:
room-assistant textPara usar voz
Necesitas un modelo Vosk, que puedes encontrar pre entrenado por Google.
Después, descomprímelo y pongo en el env.
VOSK_MODEL_PATH="/ruta/al/modelo-vosk"
ROOM_ASSISTANT_COMMAND_STT="auto"
ROOM_ASSISTANT_TTS_BACKEND="edge-tts"Para usar música
NAVIDROME_URL="http://127.0.0.1:4533"
NAVIDROME_USERNAME="tu-usuario"
NAVIDROME_PASSWORD="tu-password"Para usar Home Assistant
HOME_ASSISTANT_URL="http://127.0.0.1:8123"
HOME_ASSISTANT_TOKEN="tu-token"Variables útiles
| Variable | Para qué sirve |
|---|---|
ROOM_ASSISTANT_WAKE_WORD | Frase de activación |
ROOM_ASSISTANT_MICROPHONE_DEVICE | Elegir micrófono |
ROOM_ASSISTANT_SAMPLE_RATE | Frecuencia del micrófono |
ROOM_ASSISTANT_MEMORY_PATH | Archivo de memoria |
ROOM_ASSISTANT_ROUTINES_PATH | Archivo de rutinas |
ROOM_ASSISTANT_PLAYER | Reproductor, normalmente mpv |
En general
- empieza con texto
- luego activa voz
- luego añade música y Home Assistant si los necesitas