pi-assistant

pi-assistant is a tool-calling assistant designed for the Raspberry Pi. It can answer knowledge questions, provide weather updates, and control your smart home devices using small language models, wake word detection, automatic speech recognition (ASR), and text-to-speech (TTS). Read more in my blog article.

Note: Currently, only tested on Raspberry Pi 5 (16GB RAM).

---

Features

• Ask for weather or general knowledge
• Control your smart home (e.g., Philips Hue)
• Wake word detection (“Hey Jarvis”)
• ASR and TTS integration

---

Setup

Philips Hue Integration

For connecting with Philips Hue, please follow the official setup instructions: Philips Hue Developer Getting Started

Installation

Run the provided setup script to install dependencies:

./setup_pi.sh

Note: Sometimes you may need to run the script twice and restart the Raspberry Pi terminal for all dependencies to be installed correctly.

---

Usage

Terminal Mode

Run the assistant in text mode:

poetry run pia

Audio Mode (ASR and TTS)

Enable voice input/output with:

poetry run pia --audio

Say “Hey Jarvis” to activate the assistant.

Debug Mode

For verbose logging, use:

poetry run pia --verbose