How gauravvv15/janv works
JANV is a modular desktop assistant: keyboard or voice input is split into commands, classified by intent, routed to handlers, and returned as spoken or printed responses. Its capabilities include app launching, search, Spotify automation, memory, notes, tasks, configuration, statistics, and desktop reminders. The map also shows persistence, logging, and desktop lifecycle services. Connections are limited to calls shown in excerpts or references in the source index; several service and feature details are documented but not sampled.
Main entry points: engine.py Assistant Engine · router.py Intent Router · tasks.py Task Manager · json_manager.py JSON Persistence
Components 23
Command Runtime
- Assistant Engine
janv/core/engine.py - Command Splitter
janv/features/commands.py - Intent Parser
janv/core/intent.py - Intent Router
janv/core/router.py
Assistant Features
- Response Engine
janv/features/responses.py - App Launcher Search
janv/features/commands.py - Spotify Automation
janv/features/autogui.py - Voice System Actions
janv/features/system.py
Personal Data
- Runtime Memory
janv/core/memory.py - Notes
janv/modules/notes.py - Task Manager
janv/modules/tasks.py - Configuration
janv/core/config.py - System Statistics
janv/core/system_stats.py - Command Logging
janv/core/logger.py - JSON Persistence
janv/utilis/json_manager.py - Data Paths
janv/core/paths.py
Desktop Services
- Assistant Initializer
janv/core/initializer.py - Reminder Service
janv/services/reminder_service.py - Notifications
janv/services/notification_services.py - Desktop Service
janv/services/janv_service.py - System Tray
janv/services/tray_service.py - Startup Service
janv/services/startup_service.py
Other components
- User
Connections 31
- User → Assistant Engine: enters commands
README.md - Assistant Engine → Command Splitter: splits input
janv/core/engine.py - Assistant Engine → Intent Router: routes commands
janv/core/engine.py - Intent Router → Intent Parser: detects intent
janv/core/router.py - Intent Router → App Launcher Search: dispatches commands
janv/core/router.py - Intent Router → Spotify Automation: dispatches music
janv/core/router.py - Intent Router → Voice System Actions: dispatches actions
janv/core/router.py - Intent Router → Response Engine: uses responses
janv/core/router.py - Assistant Engine → Runtime Memory: creates memory
janv/core/engine.py - Assistant Engine → Notes: creates notes
janv/core/engine.py - Assistant Engine → Task Manager: creates tasks
janv/core/engine.py - Intent Router → Runtime Memory: dispatches memory
janv/core/router.py - Intent Router → Notes: dispatches notes
janv/core/router.py - Intent Router → Task Manager: dispatches tasks
janv/core/router.py - Assistant Engine → Command Logging: logs command
janv/core/engine.py - Assistant Engine → System Statistics: updates statistics
janv/core/engine.py - Intent Router → Configuration: dispatches settings
janv/core/router.py - Assistant Engine → Assistant Initializer: initializes runtime
janv/core/engine.py - Assistant Engine → Reminder Service: starts reminders
janv/core/engine.py - Assistant Engine → Notifications: sends activation
janv/core/engine.py - Reminder Service → Task Manager: checks due tasks
janv/services/reminder_service.py - Reminder Service → Notifications: sends reminders
janv/services/reminder_service.py - JSON Persistence → Data Paths: uses data path
janv/utilis/json_manager.py - Configuration → JSON Persistence: loads settings
janv/core/config.py - Notes → JSON Persistence: loads intents
janv/modules/notes.py - Task Manager → JSON Persistence: loads intents
janv/modules/tasks.py - Desktop Service → Assistant Engine: runs assistant
janv/services/janv_service.py - Desktop Service → System Tray: starts tray
janv/services/janv_service.py - Desktop Service → Startup Service: starts startup
janv/services/janv_service.py - System Tray → Assistant Engine: wakes or restarts
janv/services/tray_service.py - System Tray → Startup Service: controls startup
janv/services/tray_service.py