How suresh93-pro/maya-ai-v100 works
MAYA is a Windows desktop voice assistant. Its main workflow is voice or text input through the Tkinter app, command interpretation, then speech feedback or Windows/web actions; optional Ollama answers are used for otherwise-unhandled requests. The README also describes an animated HUD and telemetry, represented alongside the command workflow. The excerpts show the main wiring and core runtime behavior; feature coverage beyond those excerpts is based on README statements, so undocumented internal links are omitted.
Main entry points: main.py MAYA App and HUD · commands.py Command Engine · listener.py Voice Listener · launcher.py Windows Launcher
Components 15
Desktop Interface
- MAYA App and HUD
main.py - System Telemetry
main.py - Configuration
core/config.py
Voice Interaction
- Voice Listener
core/listener.py - Voice Speaker
core/speaker.py
Command Handling
- Command Engine
core/commands.py - Windows Launcher
core/launcher.py - Desktop Controls
core/commands.py
System Integrations
- Local AI Brain
core/brain.py
Other components
- User
- Microphone
- Google Speech Recognition
- Windows System
- Web Browser
- Ollama Service
Connections 20
- User → MAYA App and HUD: enters text
main.py - MAYA App and HUD → Configuration: loads settings
main.py - MAYA App and HUD → Voice Listener: starts listening
main.py - Voice Listener → Microphone: captures audio
core/listener.py - Voice Listener → Google Speech Recognition: recognizes speech
core/listener.py - MAYA App and HUD → Command Engine: submits commands
main.py - Voice Listener → MAYA App and HUD: returns transcript
main.py - MAYA App and HUD → Voice Speaker: speaks startup
main.py - Command Engine → Voice Speaker: speaks replies
core/commands.py - Command Engine → Windows Launcher: routes app and web requests
core/commands.py - Command Engine → Desktop Controls: executes controls
core/commands.py - Desktop Controls → Windows System: sends shortcuts
core/commands.py - Windows Launcher → Windows System: opens and closes apps
core/launcher.py - Windows Launcher → Web Browser: opens URLs
core/launcher.py - Command Engine → Local AI Brain: asks fallback question
core/commands.py - Local AI Brain → Ollama Service: requests generation
core/brain.py - MAYA App and HUD → System Telemetry: updates status
main.py - MAYA App and HUD → Command Engine: passes configuration
main.py - MAYA App and HUD → Windows Launcher: passes configuration
main.py - MAYA App and HUD → Local AI Brain: passes configuration
main.py