# gauravvv15/janv architecture

> Architecture diagram of the GitHub repository gauravvv15/janv, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gauravvv15/janv
- Repository: https://github.com/gauravvv15/janv

## Overview

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: [`janv/core/engine.py`](https://github.com/gauravvv15/janv/blob/main/janv/core/engine.py) (Assistant Engine), [`janv/core/router.py`](https://github.com/gauravvv15/janv/blob/main/janv/core/router.py) (Intent Router), [`janv/modules/tasks.py`](https://github.com/gauravvv15/janv/blob/main/janv/modules/tasks.py) (Task Manager), [`janv/utilis/json_manager.py`](https://github.com/gauravvv15/janv/blob/main/janv/utilis/json_manager.py) (JSON Persistence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Command Runtime"]
  node_engine["Assistant Engine<br/>[engine.py]"]
  node_splitter["Command Splitter<br/>[commands.py]"]
  node_intent["Intent Parser<br/>[intent.py]"]
  node_router["Intent Router<br/>[router.py]"]
end

subgraph group_features["Assistant Features"]
  node_responses["Response Engine<br/>[responses.py]"]
  node_commands["App Launcher Search<br/>[commands.py]"]
  node_autogui["Spotify Automation<br/>[autogui.py]"]
  node_system["Voice System Actions<br/>[system.py]"]
end

subgraph group_state["Personal Data"]
  node_memory["Runtime Memory<br/>[memory.py]"]
  node_notes["Notes<br/>[notes.py]"]
  node_tasks["Task Manager<br/>[tasks.py]"]
  node_config["Configuration<br/>[config.py]"]
  node_stats["System Statistics<br/>[system_stats.py]"]
  node_logger["Command Logging<br/>[logger.py]"]
  node_json[("JSON Persistence<br/>[json_manager.py]")]
  node_paths["Data Paths<br/>[paths.py]"]
end

subgraph group_desktop["Desktop Services"]
  node_initializer["Assistant Initializer<br/>[initializer.py]"]
  node_reminders["Reminder Service"]
  node_notifications["Notifications"]
  node_janv_service["Desktop Service<br/>[janv_service.py]"]
  node_tray["System Tray<br/>[tray_service.py]"]
  node_startup["Startup Service<br/>[startup_service.py]"]
end

node_user(("User"))

node_user -->|"enters commands"| node_engine
node_engine -->|"splits input"| node_splitter
node_engine -->|"routes commands"| node_router
node_router -->|"detects intent"| node_intent
node_router -->|"dispatches commands"| node_commands
node_router -->|"dispatches music"| node_autogui
node_router -->|"dispatches actions"| node_system
node_router -->|"uses responses"| node_responses
node_engine -->|"creates memory"| node_memory
node_engine -->|"creates notes"| node_notes
node_engine -->|"creates tasks"| node_tasks
node_router -->|"dispatches memory"| node_memory
node_router -->|"dispatches notes"| node_notes
node_router -->|"dispatches tasks"| node_tasks
node_engine -->|"logs command"| node_logger
node_engine -->|"updates statistics"| node_stats
node_router -->|"dispatches settings"| node_config
node_engine -->|"initializes runtime"| node_initializer
node_engine -->|"starts reminders"| node_reminders
node_engine -->|"sends activation"| node_notifications
node_reminders -->|"checks due tasks"| node_tasks
node_reminders -->|"sends reminders"| node_notifications
node_json -->|"uses data path"| node_paths
node_config -->|"loads settings"| node_json
node_notes -->|"loads intents"| node_json
node_tasks -->|"loads intents"| node_json
node_janv_service -->|"runs assistant"| node_engine
node_janv_service -->|"starts tray"| node_tray
node_janv_service -->|"starts startup"| node_startup
node_tray -->|"wakes or restarts"| node_engine
node_tray -->|"controls startup"| node_startup

click node_engine "https://github.com/gauravvv15/janv/blob/main/janv/core/engine.py"
click node_splitter "https://github.com/gauravvv15/janv/blob/main/janv/features/commands.py"
click node_intent "https://github.com/gauravvv15/janv/blob/main/janv/core/intent.py"
click node_router "https://github.com/gauravvv15/janv/blob/main/janv/core/router.py"
click node_responses "https://github.com/gauravvv15/janv/blob/main/janv/features/responses.py"
click node_commands "https://github.com/gauravvv15/janv/blob/main/janv/features/commands.py"
click node_autogui "https://github.com/gauravvv15/janv/blob/main/janv/features/autogui.py"
click node_system "https://github.com/gauravvv15/janv/blob/main/janv/features/system.py"
click node_memory "https://github.com/gauravvv15/janv/blob/main/janv/core/memory.py"
click node_notes "https://github.com/gauravvv15/janv/blob/main/janv/modules/notes.py"
click node_tasks "https://github.com/gauravvv15/janv/blob/main/janv/modules/tasks.py"
click node_config "https://github.com/gauravvv15/janv/blob/main/janv/core/config.py"
click node_stats "https://github.com/gauravvv15/janv/blob/main/janv/core/system_stats.py"
click node_logger "https://github.com/gauravvv15/janv/blob/main/janv/core/logger.py"
click node_json "https://github.com/gauravvv15/janv/blob/main/janv/utilis/json_manager.py"
click node_paths "https://github.com/gauravvv15/janv/blob/main/janv/core/paths.py"
click node_initializer "https://github.com/gauravvv15/janv/blob/main/janv/core/initializer.py"
click node_reminders "https://github.com/gauravvv15/janv/blob/main/janv/services/reminder_service.py"
click node_notifications "https://github.com/gauravvv15/janv/blob/main/janv/services/notification_services.py"
click node_janv_service "https://github.com/gauravvv15/janv/blob/main/janv/services/janv_service.py"
click node_tray "https://github.com/gauravvv15/janv/blob/main/janv/services/tray_service.py"
click node_startup "https://github.com/gauravvv15/janv/blob/main/janv/services/startup_service.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_engine,node_splitter,node_intent,node_router,node_user toneBlue
class node_responses,node_commands,node_autogui,node_system toneAmber
class node_memory,node_notes,node_tasks,node_config,node_stats,node_logger,node_json,node_paths toneMint
class node_initializer,node_reminders,node_notifications,node_janv_service,node_tray,node_startup toneRose
```

## Components

### Command Runtime

- [Assistant Engine](https://github.com/gauravvv15/janv/blob/main/janv/core/engine.py): `janv/core/engine.py`
- [Command Splitter](https://github.com/gauravvv15/janv/blob/main/janv/features/commands.py): `janv/features/commands.py`
- [Intent Parser](https://github.com/gauravvv15/janv/blob/main/janv/core/intent.py): `janv/core/intent.py`
- [Intent Router](https://github.com/gauravvv15/janv/blob/main/janv/core/router.py): `janv/core/router.py`

### Assistant Features

- [Response Engine](https://github.com/gauravvv15/janv/blob/main/janv/features/responses.py): `janv/features/responses.py`
- [App Launcher Search](https://github.com/gauravvv15/janv/blob/main/janv/features/commands.py): `janv/features/commands.py`
- [Spotify Automation](https://github.com/gauravvv15/janv/blob/main/janv/features/autogui.py): `janv/features/autogui.py`
- [Voice System Actions](https://github.com/gauravvv15/janv/blob/main/janv/features/system.py): `janv/features/system.py`

### Personal Data

- [Runtime Memory](https://github.com/gauravvv15/janv/blob/main/janv/core/memory.py): `janv/core/memory.py`
- [Notes](https://github.com/gauravvv15/janv/blob/main/janv/modules/notes.py): `janv/modules/notes.py`
- [Task Manager](https://github.com/gauravvv15/janv/blob/main/janv/modules/tasks.py): `janv/modules/tasks.py`
- [Configuration](https://github.com/gauravvv15/janv/blob/main/janv/core/config.py): `janv/core/config.py`
- [System Statistics](https://github.com/gauravvv15/janv/blob/main/janv/core/system_stats.py): `janv/core/system_stats.py`
- [Command Logging](https://github.com/gauravvv15/janv/blob/main/janv/core/logger.py): `janv/core/logger.py`
- [JSON Persistence](https://github.com/gauravvv15/janv/blob/main/janv/utilis/json_manager.py): `janv/utilis/json_manager.py`
- [Data Paths](https://github.com/gauravvv15/janv/blob/main/janv/core/paths.py): `janv/core/paths.py`

### Desktop Services

- [Assistant Initializer](https://github.com/gauravvv15/janv/blob/main/janv/core/initializer.py): `janv/core/initializer.py`
- [Reminder Service](https://github.com/gauravvv15/janv/blob/main/janv/services/reminder_service.py): `janv/services/reminder_service.py`
- [Notifications](https://github.com/gauravvv15/janv/blob/main/janv/services/notification_services.py): `janv/services/notification_services.py`
- [Desktop Service](https://github.com/gauravvv15/janv/blob/main/janv/services/janv_service.py): `janv/services/janv_service.py`
- [System Tray](https://github.com/gauravvv15/janv/blob/main/janv/services/tray_service.py): `janv/services/tray_service.py`
- [Startup Service](https://github.com/gauravvv15/janv/blob/main/janv/services/startup_service.py): `janv/services/startup_service.py`

### Other components

- **User**

## Connections

- User → Assistant Engine: enters commands (evidence: `README.md`)
- Assistant Engine → Command Splitter: splits input (evidence: `janv/core/engine.py`)
- Assistant Engine → Intent Router: routes commands (evidence: `janv/core/engine.py`)
- Intent Router → Intent Parser: detects intent (evidence: `janv/core/router.py`)
- Intent Router → App Launcher Search: dispatches commands (evidence: `janv/core/router.py`)
- Intent Router → Spotify Automation: dispatches music (evidence: `janv/core/router.py`)
- Intent Router → Voice System Actions: dispatches actions (evidence: `janv/core/router.py`)
- Intent Router → Response Engine: uses responses (evidence: `janv/core/router.py`)
- Assistant Engine → Runtime Memory: creates memory (evidence: `janv/core/engine.py`)
- Assistant Engine → Notes: creates notes (evidence: `janv/core/engine.py`)
- Assistant Engine → Task Manager: creates tasks (evidence: `janv/core/engine.py`)
- Intent Router → Runtime Memory: dispatches memory (evidence: `janv/core/router.py`)
- Intent Router → Notes: dispatches notes (evidence: `janv/core/router.py`)
- Intent Router → Task Manager: dispatches tasks (evidence: `janv/core/router.py`)
- Assistant Engine → Command Logging: logs command (evidence: `janv/core/engine.py`)
- Assistant Engine → System Statistics: updates statistics (evidence: `janv/core/engine.py`)
- Intent Router → Configuration: dispatches settings (evidence: `janv/core/router.py`)
- Assistant Engine → Assistant Initializer: initializes runtime (evidence: `janv/core/engine.py`)
- Assistant Engine → Reminder Service: starts reminders (evidence: `janv/core/engine.py`)
- Assistant Engine → Notifications: sends activation (evidence: `janv/core/engine.py`)
- Reminder Service → Task Manager: checks due tasks (evidence: `janv/services/reminder_service.py`)
- Reminder Service → Notifications: sends reminders (evidence: `janv/services/reminder_service.py`)
- JSON Persistence → Data Paths: uses data path (evidence: `janv/utilis/json_manager.py`)
- Configuration → JSON Persistence: loads settings (evidence: `janv/core/config.py`)
- Notes → JSON Persistence: loads intents (evidence: `janv/modules/notes.py`)
- Task Manager → JSON Persistence: loads intents (evidence: `janv/modules/tasks.py`)
- Desktop Service → Assistant Engine: runs assistant (evidence: `janv/services/janv_service.py`)
- Desktop Service → System Tray: starts tray (evidence: `janv/services/janv_service.py`)
- Desktop Service → Startup Service: starts startup (evidence: `janv/services/janv_service.py`)
- System Tray → Assistant Engine: wakes or restarts (evidence: `janv/services/tray_service.py`)
- System Tray → Startup Service: controls startup (evidence: `janv/services/tray_service.py`)
