How dwizsharma/jarvis-linux works
Jarvis is a headless, offline voice assistant for Linux. Its main workflow is to load voice settings, listen for a wake phrase and command, parse the command, operate the desktop through AT-SPI or launch an app, then speak a response. The README also documents multilingual recognition, screenshots, and configurable voice feedback. The sampled code shows the core dispatch and desktop operations; unsampled wake-loop details and some platform wiring are represented only where the README supports them.
Main entry points: wake.py Wake and speech loop · accessibility.py AT-SPI desktop controls · commands.py Command parser · settings.py Voice settings
Components 13
Voice workflow
- Jarvis entry
src/jarvis/app.py - Wake and speech loop
src/jarvis/wake.py - Command parser
src/jarvis/commands.py - Vosk models
Configuration
- Voice settings
src/jarvis/settings.py - TOML config
Desktop integrations
- AT-SPI desktop controls
src/jarvis/accessibility.py
Other components
- User
- Microphone
- Desktop app registry
- Screenshot tools
- Speech Dispatcher
- Desktop notifications
Connections 13
- User → Microphone: speaks to
README.md - Jarvis entry → Wake and speech loop: starts
src/jarvis/app.py - Wake and speech loop → Voice settings: loads
src/jarvis/wake.py - TOML config → Voice settings: configures
README.md - Microphone → Wake and speech loop: streams audio
README.md - Vosk models → Wake and speech loop: recognizes speech
README.md - Wake and speech loop → Command parser: dispatches commands
src/jarvis/wake.py - Wake and speech loop → AT-SPI desktop controls: supplies action handlers
src/jarvis/wake.py - Command parser → AT-SPI desktop controls: invokes handlers
src/jarvis/commands.py - AT-SPI desktop controls → Desktop app registry: launches apps through
src/jarvis/accessibility.py - AT-SPI desktop controls → Screenshot tools: runs screenshot tool
src/jarvis/accessibility.py - Wake and speech loop → Speech Dispatcher: speaks responses
src/jarvis/wake.py - Wake and speech loop → Desktop notifications: reports errors
src/jarvis/wake.py