How yashhhseella/mirrormuse-public works
MirrorMuse is a local, voice-first smart-mirror assistant: users speak or type in the browser, chat requests pass through Next.js proxy routes to the Fastify backend, and the backend enriches prompts with RAG before local-LLM inference and MCP tool execution. Separate branches serve dashboard data, named briefings, live SSE events, Spotify controls, and speech synthesis. The README documents the broad service wiring; source excerpts and the index confirm selected calls. LuxTTS internals and several UI routes were not sampled, so those links are shown only where documented.
Main entry points: index.ts Fastify routes · dashboard.ts Dashboard aggregator · page.tsx Next.js screens · mcp.ts MCP tools
Components 24
Mirror UI
- Next.js screens
apps/ui/app/page.tsx - Voice interface
apps/ui/components/VoiceAgent.tsx - Chat proxy
apps/ui/app/api/chat/route.ts - Chat stream proxy
apps/ui/app/api/chat/stream/route.ts - Dashboard proxy
apps/ui/app/api/dashboard/route.ts - SSE proxy
apps/ui/app/api/sse/route.ts - TTS proxy
apps/ui/app/api/tts/route.ts
Backend workflows
- Fastify routes
apps/server/src/index.ts - RAG retrieval
apps/server/src/services/rag.ts - Local LLM
apps/server/src/services/llm.ts - MCP tools
apps/server/src/services/mcp.ts - Briefing workflows
apps/server/src/services/protocols.ts - Event broadcast
apps/server/src/index.ts
Data and integrations
- Dashboard aggregator
apps/server/src/services/dashboard.ts - News feeds
apps/server/src/services/news.ts - Calendar cache
apps/server/src/services/calendarCache.ts - Traffic data
apps/server/src/services/traffic.ts - Spotify integration
apps/server/src/services/spotifyAuth.ts - Countdown events
apps/server/src/services/events.ts
Speech synthesis
- TTS runtime
runtime/lux_tts_server.py - LuxVoice engine
LuxTTS/zipvoice/luxvoice.py
Other components
- Mirror user
- External APIs
- Local inference endpoint
Connections 30
- Mirror user → Next.js screens: uses
- Mirror user → Voice interface: speaks to
- Voice interface → Chat proxy: sends chat
- Next.js screens → Dashboard proxy: polls
- Next.js screens → SSE proxy: listens on
- Chat proxy → Fastify routes: proxies to
- Chat stream proxy → Fastify routes: proxies to
- Dashboard proxy → Fastify routes: proxies to
- SSE proxy → Fastify routes: proxies to
- Fastify routes → RAG retrieval: searches
apps/server/src/index.ts - Fastify routes → Local LLM: builds and streams
apps/server/src/index.ts - Fastify routes → MCP tools: dispatches tools
apps/server/src/index.ts - Local LLM → Local inference endpoint: requests inference
apps/server/src/services/llm.ts - Fastify routes → Dashboard aggregator: serves dashboard
apps/server/src/index.ts - Dashboard aggregator → News feeds: uses news data
apps/server/src/services/dashboard.ts - Dashboard aggregator → Calendar cache: uses cached events
apps/server/src/services/dashboard.ts - Fastify routes → Briefing workflows: builds briefings
apps/server/src/index.ts - Briefing workflows → Event broadcast: broadcasts results
apps/server/src/index.ts - Fastify routes → Countdown events: reads and writes
apps/server/src/index.ts - MCP tools → Dashboard aggregator: fetches weather
apps/server/src/services/mcp.ts - MCP tools → Traffic data: fetches traffic
apps/server/src/services/mcp.ts - Fastify routes → Spotify integration: routes playback
apps/server/src/index.ts - Dashboard aggregator → External APIs: fetches feed data
- News feeds → External APIs: fetches news
apps/server/src/services/news.ts - Traffic data → External APIs: queries route data
- Calendar cache → External APIs: loads calendar data
- Spotify integration → External APIs: uses Spotify API
- TTS proxy → Fastify routes: proxies speech
- Fastify routes → TTS runtime: selects TTS provider
- TTS runtime → LuxVoice engine: invokes engine
runtime/lux_tts_server.py