Guía de setup
La forma más simple de instalar Room Assistant y probar que funciona.
Si vas a usar una Raspberry Pi, considera leer el documento Raspberry Pi
1. Instala dependencias del sistema
En Debian, Ubuntu o Raspberry Pi OS:
sudo apt update
sudo apt install -y python3 python3-venv python3-pip git mpv2. Descarga el proyecto
git clone https://github.com/SrIzan10/room-assistant.git
cd room-assistant3. Crea el entorno virtual
python3 -m venv .venv
source .venv/bin/activate
pip install -e .4. Pon la configuración mínima
Puedes usar variables de entorno o un archivo .env.
export OPENAI_API_KEY="tu-api-key"
export OPENAI_MODEL="google/gemma-4-31b-it"
export OPENAI_BASE_URL="https://openrouter.ai/api/v1"
export ROOM_ASSISTANT_WAKE_WORD="oye room"5. Prueba primero en texto
room-assistant textPrueba con esto:
> que puedes hacer6. Si quieres voz
Descarga un modelo Vosk y exporta su ruta:
export VOSK_MODEL_PATH="/ruta/absoluta/al/modelo-vosk"Después:
room-assistant list-microphones
room-assistant voice7. Si quieres música
export NAVIDROME_URL="http://127.0.0.1:4533"
export NAVIDROME_USERNAME="tu-usuario"
export NAVIDROME_PASSWORD="tu-password"8. Si quieres Home Assistant
export HOME_ASSISTANT_URL="http://127.0.0.1:8123"
export HOME_ASSISTANT_TOKEN="tu-token"9. Si la voz falla, usa esto
room-assistant simulateY escribe:
mic> oye room
mic> que puedes hacer