Instalación en Raspberry Pi
Pasos sencillos para montar Room Assistant en una Raspberry Pi.
Si quieres dedicar una Raspberry Pi a este proyecto, esta es la forma más simple de hacerlo.
Hardware recomendado
- Raspberry Pi 4
- micrófono USB
- altavoz o salida de audio
- red estable
1. Instala paquetes base
sudo apt update
sudo apt upgrade -y
sudo apt install -y python3 python3-venv python3-pip git mpv2. Descarga e instala el proyecto
git clone https://github.com/SrIzan10/room-assistant.git
cd room-assistant
python3 -m venv .venv
source .venv/bin/activate
pip install -e .3. Pon la configuración mínima
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"4. Prueba primero en texto
room-assistant textHaz esto antes de tocar audio. Si funciona aquí, ya sabes que Python y el proyecto están bien.
5. Activa la voz
Descarga un modelo Vosk y define la ruta:
export VOSK_MODEL_PATH="/home/pi/models/vosk-model-small-en-us-0.15"Comprueba el micrófono:
room-assistant list-microphonesLuego arranca:
room-assistant voiceAjustes recomendados para Pi
export ROOM_ASSISTANT_WAKEWORD_BACKEND="auto"
export ROOM_ASSISTANT_COMMAND_STT="auto"
export ROOM_ASSISTANT_TTS_BACKEND="edge-tts"
export ROOM_ASSISTANT_SAMPLE_RATE="16000"Si la Pi va justa
- prueba primero
room-assistant simulate - usa Porcupine para wake word si quieres algo más ligero
- no abras demasiadas cosas a la vez
Si quieres Porcupine
export PORCUPINE_ACCESS_KEY="tu-access-key"
export ROOM_ASSISTANT_PORCUPINE_KEYWORD_PATH="/ruta/a/oye-room.ppn"
export ROOM_ASSISTANT_WAKEWORD_BACKEND="porcupine"