Skip to content

bagg3rs/naboo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🤖 Naboo

"If I only had a brain…"

Naboo is a family AI robot. They started life as a stock mBot2 — plastic wheels, ultrasonic sensors, a bit of pre-programmed wiggling. Then we gave them a brain.

This repo documents the journey from stock robot to physical AI agent: natural language understanding, voice responses, camera vision, autonomous navigation, and a personality the kids genuinely love.


What Naboo Can Do

  • Talk back — voice commands via Home Assistant wake word ("hey Naboo"), responses via HA TTS using the Ryan Cheerful voice
  • ThinkStrands agents powering 3-tier LLM routing: fast local responses, smart local responses, cloud fallback
  • See — camera with real-time scene analysis and object detection
  • Move intelligently — autonomous exploration, obstacle avoidance, shape drawing, room mapping
  • Remember — persistent family context: knows who Ziggy and Lev are, their interests, their bedtime

The Stack

Layer Technology
Robot body mBot2 (CyberPi / ESP32)
Agent framework Strands Agents
Local LLM MLX / Qwen 2.5 7B (Mac mini M4, ~3s)
Cloud LLM AWS Bedrock / Claude (fallback)
Voice in Home Assistant wake word ("hey Naboo")
Voice out Home Assistant TTS — Ryan Cheerful (edge TTS)
Vision Camera + Claude Vision
Messaging MQTT (Mosquitto on Mac mini)
Home automation Home Assistant

The Story

Read the full build log: bagg3rs.github.io/naboo

Quick Start

git clone git@github.com:bagg3rs/naboo.git
cd naboo
cp infra/.env.example infra/.env
# Edit .env with your MQTT + (optionally) AWS config
uv run python3 -m naboo

Project Structure

naboo/
├── naboo/          # Core agent — Strands, tools, prompts, memory
├── infra/          # MQTT config, env files, Docker
├── docs/           # GitHub Pages build log
└── scripts/        # Test utilities

Status

Component Status
Strands agent ✅ Running
Voice pipeline (HA wake word + TTS) ✅ Running
3-tier LLM routing ✅ Running
MLX inference (Mac mini M4) ✅ Running
Persistent family memory ✅ Running
User identification ("I'm Ziggy") ✅ Running
Camera / vision 🔄 In progress
Autonomous navigation 🔄 In progress

Named after the Home Assistant wake word. Ziggy (6) picked it. Non-negotiable.

About

No description or website provided.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages