How mayank14211/grace_voice_agent works
GRACE is a voice-controlled desktop assistant. The main workflow is a user speaking a wake word and command, which the controller routes to a capability and reports through speech. The README also documents screen reading, selected-text code analysis, dictation, system control, and AI image generation. The excerpts show module implementations and imports, but not all controller dispatch details; edges are limited to documented or indexed relationships. Hand-gesture control appears as a separate implementation, with no shown connection to the main workflow.
Main entry points: main.py Main controller · screen_reader.py Screen reader · speech_recognition_module.py Speech recognition · system_control.py System control
Components 15
Voice interaction
- Main controller
main.py - Speech recognition
speech_recognition_module.py - Text to speech
tts.py
Assistant capabilities
- System control
system_control.py - Screen reader
screen_reader.py - Code analysis
screen_reader.py - Image generation
main.py
External integrations
- Microphone
- Desktop environment
- Tesseract OCR
- Gemini AI
- AI image service
- Webcam
Gesture control
- Gesture controller
Hand_Gesture.py
Other components
- User
Connections 15
- User → Microphone: speaks commands
README.md - Microphone → Speech recognition: provides audio
speech_recognition_module.py - Speech recognition → Main controller: transcribes commands
README.md - Main controller → System control: routes commands
README.md - Main controller → Screen reader: routes reading requests
README.md - Main controller → Code analysis: routes analysis requests
README.md - Main controller → Image generation: handles generation
main.py - Main controller → Text to speech: speaks responses
main.py - Screen reader → Tesseract OCR: extracts screen text
screen_reader.py - Screen reader → Desktop environment: captures screen
screen_reader.py - Code analysis → Gemini AI: analyzes code
README.md - System control → Desktop environment: controls applications
system_control.py - Image generation → AI image service: requests images
main.py - Webcam → Gesture controller: supplies frames
Hand_Gesture.py - Gesture controller → Desktop environment: controls pointer
Hand_Gesture.py