How brenoxbr/jarvis-ai works
J.A.R.V.I.S. is a Windows-oriented personal assistant for developers, offering chat, voice interaction, system automation, screen analysis, debugging help, and persistent memory. The documented primary launch path initializes logging, system actions, and the assistant core, then opens the GUI. A second Qt-based interface and threaded voice/AI runtime appear in the repository as a separate integration path. The README documents additional capabilities, but their wiring to the primary launcher is not established by the sampled excerpts; those branches are shown without guessed connections.
Main entry points: jarvis_threads.py Thread Manager · main.py Application Launcher · action_handler.py Command Handling · actions.py System Actions
Components 21
User Interfaces
- Application Launcher
main.py - Desktop Chat UI
gui.py - Qt Assistant UI
jarvis_gui.py
Assistant Runtime
- Logging
logger.py - Assistant Core
core.py - Thread Manager
jarvis_threads.py
Assistant Capabilities
- Command Handling
action_handler.py - System Actions
actions.py - Windows Controls
jarvis_system_controller.py - Screen Vision
jarvis_vision.py - Assisted Debugging
debug_mode.py - Python Code Generation
code_generator.py - Multi-Language Code
multi_language_generator.py - Workspace Cleanup
jarvis_cleanup.py - Mobile Bridge
mobile_bridge.py
State and Integrations
- Long-Term Memory
jarvis_memory.py - Configuration
config.py
Other components
- User
- Google Gemini
- Windows System
- Local Memory Files
Connections 25
- User → Application Launcher: starts
- Application Launcher → Logging: creates
main.py - Application Launcher → System Actions: creates
main.py - Application Launcher → Assistant Core: creates
main.py - Application Launcher → Desktop Chat UI: opens
main.py - User → Desktop Chat UI: uses
- User → Qt Assistant UI: uses
- Qt Assistant UI → Thread Manager: submits commands
jarvis_gui.py - Thread Manager → Screen Vision: initializes
jarvis_threads.py - Thread Manager → Workspace Cleanup: initializes
jarvis_threads.py - Thread Manager → Long-Term Memory: initializes
jarvis_threads.py - Thread Manager → Command Handling: initializes
jarvis_threads.py - Thread Manager → Mobile Bridge: initializes
jarvis_threads.py - Command Handling → Google Gemini: configures
action_handler.py - Command Handling → Python Code Generation: uses
- Command Handling → Multi-Language Code: uses
- Multi-Language Code → Assisted Debugging: references
multi_language_generator.py - System Actions → Configuration: imports
actions.py - System Actions → Windows System: controls
actions.py - Windows Controls → Windows System: controls
jarvis_system_controller.py - Screen Vision → Windows System: captures screen
- Long-Term Memory → Local Memory Files: persists JSON
- Assistant Core → Google Gemini: uses
- User → Assisted Debugging: requests analysis
- User → System Actions: requests automation