How kananyan2311/loona works
L.O.O.N.A. is a distributed companion rover: a Python brain coordinates vision, AI, memory, speech, music and navigation, with web and embedded controllers providing user interaction and physical control. The README documents the broader capabilities; sampled Python excerpts and the source index support the brain’s service relationships. Firmware and web UI internals were not sampled, so their connections are limited to documented architecture and capabilities.
Main entry points: main.py Brain Server · memory_service.py Memory Vault · module1_head_cam.ino Head Camera · vision_tracker.py Vision Tracking
Components 17
User Interaction
- Web Cockpit
module4_webapp/index.html
Python Brain
- Brain Server
module3_python_brain/main.py - Configuration
module3_python_brain/config.py
Robot Services
- Vision Tracking
module3_python_brain/vision_tracker.py - AI Reasoning
module3_python_brain/ai_service.py - Idle Roaming
module3_python_brain/roam_service.py - Memory Vault
module3_python_brain/memory_service.py - SQLite Memory
module3_python_brain/database.py - Speech Synthesis
module3_python_brain/tts_service.py - Music Streaming
module3_python_brain/spotify_service.py - Photo Captures
module3_python_brain/data/captures
Embedded Hardware
- Head Camera
module1_head_cam/module1_head_cam.ino - Camera Pin Map
module1_head_cam/camera_pins.h - Chassis Motion
module2_chassis_motion/module2_chassis_motion.ino
Other components
- User
- Gemini AI
- Music Provider
Connections 20
- User → Web Cockpit: operates
README.md - Web Cockpit → Brain Server: controls via API
README.md - Brain Server → Vision Tracking: uses tracking
module3_python_brain/main.py - Brain Server → AI Reasoning: dispatches requests
module3_python_brain/main.py - Brain Server → Idle Roaming: coordinates roaming
module3_python_brain/main.py - Brain Server → Memory Vault: updates vault
module3_python_brain/main.py - Brain Server → Speech Synthesis: uses speech
module3_python_brain/main.py - Brain Server → Music Streaming: controls playback
module3_python_brain/main.py - Brain Server → Chassis Motion: sends motion commands
README.md - Brain Server → Head Camera: coordinates streams
README.md - Brain Server → Web Cockpit: broadcasts telemetry
README.md - AI Reasoning → Memory Vault: reads commands
module3_python_brain/ai_service.py - Memory Vault → SQLite Memory: reads and writes
module3_python_brain/memory_service.py - Vision Tracking → Memory Vault: reads face records
module3_python_brain/vision_tracker.py - AI Reasoning → Gemini AI: requests reasoning
README.md - Music Streaming → Music Provider: streams audio
README.md - Speech Synthesis → Head Camera: streams speech audio
README.md - Head Camera → Camera Pin Map: uses pin definitions
README.md - Vision Tracking → Head Camera: receives camera feed
README.md - Brain Server → Photo Captures: stores photos
README.md