How maglore9900/max_headroom works
Main Components
a) Core System Components:
• Speech Input Handler (Speech-to-Text)
• Google Speech Recognition
• Faster-Whisper Option
• Natural Language Processing (LLM)
• OpenAI Integration
• Ollama Integration
• Speech Output System
• AllTalk TTS Integration
• Fallback pyttsx3 System
• Agent Orchestrator
b) Tool Integrations:
• Spotify Controller
• Windows Application Manager
• Window Focus Controller
• Timer System
• Journal System (planned)
Top Layer: User Interaction
Middle Layer: Core Processing
Bottom Layer: Tool Integration
Key Relationships
• Input Flow: Microphone → Speech Recognition → NLP Processing
• Output Flow: LLM Response → Text-to-Speech → Audio Output
• Tool Integration: Agent → Individual Tools
• Configuration System: Environment Variables → Component Configuration
Specific Implementation Details
[User Input] → [Wake Word Detection ("Hey Max")]
• ↓
[Speech Recognition] → [Agent (modules/agent.py)]
• ↓
[LLM Processing] ←→ [Character Prompt System]
• ↓
[Tool Router] → [Various Tools]
• ↓
[Speech Output] → [Audio Generation]
Important Architectural Notes
• Modular nature of the system (all tools in separate modules)
• Fallback systems (speech recognition and TTS)
• Configuration points (.env file influence)
• Character customization system