ShadowlessBlu/boafoc

Offline African multilingual AI voice assistant for Raspberry Pi 5. Speaks Twi, Akan and Ewe. Runs llama3.2:3b, OpenWakeWord, Piper TTS and faster-whisper entirely on-device. No cloud, no subscription. # Boafoc - The Helper **Offline African multilingual AI voice assistant for Raspberry Pi 5.** Boafoc ("The Helper" in Twi) is a privacy-first voice assistant built for Ghanaian and West African users. It understands and speaks Twi, Akan, and Ewe alongside English. Everything runs on the device - no cloud, no subscription, no internet required after the initial setup. --- ## Why Boafoc? Most voice assistants assume two things: a stable internet connection, and English as the primary language. Boafoc challenges both. It was built specifically for users in Ghana and the wider West African community who move between English and local languages throughout their day. The full AI pipeline - wake word detection, speech recognition, language understanding, and text-to-speech - runs entirely on a Raspberry Pi 5. Your conversations never leave the device. --- ## Features - **Custom wake word** - say "Yooree" to activate, or press a GPIO button - **Ghanaian language support** - Twi STT (Wav2Vec2), Akan STT (Whisper fine-tune), Ewe TTS (MMS VITS) - **Offline LLM** - llama3.2:3b running through Ollama, 2.2 GB quantized, no API key needed - **Sentence-streaming TTS** - starts speaking before the full reply is generated, reducing perceived latency - **I2C sensors** - BMP280 (pressure/temp), AHT40 (temp/humidity), MPU6050 (accelerometer) - **OLED status display** - 6 display modes: status, last reply, sensors, clock, system info, wake word score - **Tool dispatch** - real-time weather, alarms, file search, sensor readings, sandboxed filesystem - **Config UI** - futuristic web interface on port 8765, edit all settings without touching config files - **Disturbance detection** - MPU6050 background monitor alerts when the Pi is moved - **Auto-backup** - every config save creates a timestamped backup --- ## Quick start ```bash git clone github.com cd boafoc pip install pipenv pipenv install -r requirements.txt chmod +x scripts/download_models. …