How maanik579/reflectai works
ReflectAI is a Raspberry Pi smart mirror that identifies the person in front of it and presents personalized information and recommendations. The main workflow runs from the mirror dashboard and camera-based recognition through profile selection, weather/calendar/reminder lookup, and wardrobe or grooming advice; the dashboard also accepts ESP32 sensor updates and can present voice briefings. SQLite repositories provide shared application state. The README documents several capabilities whose implementation was not fully sampled, so those links are cited as documented behavior rather than inferred call chains.
Main entry points: dashboard.py Dashboard & API · concierge.py Voice concierge · repositories.py Repositories · calendar_service.py Calendar service
Components 18
Mirror Interface
- Dashboard & API
app/dashboard/dashboard.py
Identity & Hardware
- Face recognition
face_engine/face_service.py - ESP32 bridge
app/esp32/serial_bridge.py - Sensor firmware
firmware/esp32_firmware/esp32_firmware.ino
Personalized Services
- Weather service
app/weather/weather_service.py - Calendar service
app/calendar/calendar_service.py - Outfit engine
app/recommendations/outfit_engine.py - Clothing classifier
app/recommendations/clothing_classifier.py - Live stylist
app/recommendations/mirror_stylist.py - Grooming classifier
app/recommendations/grooming_classifier.py
Voice Assistant
- Voice concierge
app/assistant/concierge.py - Voice brain
app/assistant/brain.py - Offline voice engine
voice_engine/assistant.py
Application State
- Repositories
app/database/repositories.py - SQLite database
app/database/database.py - User profiles
data/profiles.json - Configuration
app/config/settings.py
Other components
- Mirror user
Connections 24
- Mirror user → Dashboard & API: uses
README.md - Face recognition → Dashboard & API: notifies identity
face_engine/face_service.py - Sensor firmware → Dashboard & API: posts telemetry
README.md - Dashboard & API → ESP32 bridge: uses bridge
app/dashboard/dashboard.py - Dashboard & API → Weather service: serves weather
app/dashboard/dashboard.py - Dashboard & API → Calendar service: serves schedule
app/dashboard/dashboard.py - Dashboard & API → Outfit engine: requests outfits
app/dashboard/dashboard.py - Dashboard & API → Live stylist: runs live styling
README.md - Dashboard & API → Grooming classifier: shows grooming analysis
README.md - Dashboard & API → Voice concierge: builds briefings
app/dashboard/dashboard.py - Voice concierge → Weather service: uses weather
app/assistant/concierge.py - Voice concierge → Calendar service: uses calendar
app/assistant/concierge.py - Voice concierge → Outfit engine: uses outfit data
README.md - Offline voice engine → Voice concierge: connects assistant
voice_engine/assistant.py - Outfit engine → Weather service: fetches conditions
app/recommendations/outfit_engine.py - Outfit engine → Repositories: reads wardrobe
app/recommendations/outfit_engine.py - Calendar service → Repositories: reads schedules
app/calendar/calendar_service.py - Calendar service → User profiles: reads entries
app/calendar/calendar_service.py - Voice brain → Repositories: reads and updates
app/assistant/brain.py - Repositories → SQLite database: queries and writes
app/database/repositories.py - Dashboard & API → Repositories: reads and updates
app/dashboard/dashboard.py - Dashboard & API → Clothing classifier: classifies wardrobe
README.md - Dashboard & API → Configuration: reads configuration
app/dashboard/dashboard.py - SQLite database → Configuration: uses database path
app/database/database.py