# kishanrajput23/jarvis-desktop-voice-assistant architecture

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

- Interactive diagram: https://gitdiagram.com/kishanrajput23/jarvis-desktop-voice-assistant
- Repository: https://github.com/kishanrajput23/jarvis-desktop-voice-assistant

## Overview

Jarvis is a bilingual desktop voice assistant. Its main workflow captures spoken commands, recognizes them, selects a language and command handler, then speaks a response or performs a desktop/web action. The single runtime module also provides greetings, time/date, Wikipedia lookup, music playback, screenshots, and power controls. The README additionally advertises notes, jokes, and arbitrary websites, which are not present in the sampled implementation; those documented capabilities are shown as unverified. Source evidence is limited to the README and the excerpted main script.

Main entry points: [`Jarvis/jarvis.py`](https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/blob/main/Jarvis/jarvis.py) (Command routing), [`Jarvis`](https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/tree/main/Jarvis) (Notes, jokes, websites)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Voice interaction"]
  node_command_capture["Voice capture<br/>[jarvis.py]"]
  node_command_router["Command routing<br/>[jarvis.py]"]
  node_language_strings["Language and speech<br/>[jarvis.py]"]
end

subgraph group_commands["Command features"]
  node_greetings["Greetings<br/>[jarvis.py]"]
  node_time_date["Time and date<br/>[jarvis.py]"]
  node_web_shortcuts["Web shortcuts<br/>[jarvis.py]"]
  node_wikipedia_search["Wikipedia search<br/>[jarvis.py]"]
  node_music_playback["Music playback<br/>[jarvis.py]"]
  node_screenshots["Screenshots<br/>[jarvis.py]"]
  node_system_control["Power controls<br/>[jarvis.py]"]
  node_notes_jokes_sites["Notes, jokes, websites"]
end

subgraph group_platform["Desktop and services"]
  node_speech_recognition["Speech recognition"]
  node_local_music["Local music library"]
  node_desktop_os["Desktop operating system"]
  node_browser["Browser"]
  node_wikipedia_service["Wikipedia service"]
  node_screenshot_file["Screenshot file"]
end

node_user(("User"))

node_user -->|"speaks to"| node_command_capture
node_command_capture -->|"recognizes with"| node_speech_recognition
node_command_capture -->|"returns transcript"| node_command_router
node_command_router -->|"calls at startup"| node_greetings
node_command_router -->|"dispatches to"| node_time_date
node_command_router -->|"dispatches to"| node_web_shortcuts
node_command_router -->|"dispatches to"| node_wikipedia_search
node_command_router -->|"dispatches to"| node_music_playback
node_command_router -->|"dispatches to"| node_screenshots
node_command_router -->|"dispatches to"| node_system_control
node_greetings -->|"speaks greeting"| node_language_strings
node_time_date -->|"speaks result"| node_language_strings
node_wikipedia_search -->|"requests summary"| node_wikipedia_service
node_wikipedia_search -->|"speaks summary"| node_language_strings
node_music_playback -->|"searches files"| node_local_music
node_music_playback -->|"opens selected track"| node_desktop_os
node_music_playback -->|"speaks status"| node_language_strings
node_web_shortcuts -->|"opens site"| node_browser
node_screenshots -->|"saves image"| node_screenshot_file
node_screenshots -->|"speaks saved path"| node_language_strings
node_system_control -->|"runs power command"| node_desktop_os
node_system_control -->|"speaks status"| node_language_strings
node_language_strings -->|"speaks response"| node_user
node_command_router -.->|"documented capability"| node_notes_jokes_sites

click node_command_capture "https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/blob/main/Jarvis/jarvis.py"
click node_command_router "https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/blob/main/Jarvis/jarvis.py"
click node_language_strings "https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/blob/main/Jarvis/jarvis.py"
click node_greetings "https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/blob/main/Jarvis/jarvis.py"
click node_time_date "https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/blob/main/Jarvis/jarvis.py"
click node_web_shortcuts "https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/blob/main/Jarvis/jarvis.py"
click node_wikipedia_search "https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/blob/main/Jarvis/jarvis.py"
click node_music_playback "https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/blob/main/Jarvis/jarvis.py"
click node_screenshots "https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/blob/main/Jarvis/jarvis.py"
click node_system_control "https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/blob/main/Jarvis/jarvis.py"
click node_notes_jokes_sites "https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/tree/main/Jarvis"

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_command_capture,node_command_router,node_language_strings,node_user toneBlue
class node_greetings,node_time_date,node_web_shortcuts,node_wikipedia_search,node_music_playback,node_screenshots,node_system_control,node_notes_jokes_sites toneAmber
class node_speech_recognition,node_local_music,node_desktop_os,node_browser,node_wikipedia_service,node_screenshot_file toneMint
```

## Components

### Voice interaction

- [Voice capture](https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/blob/main/Jarvis/jarvis.py): `Jarvis/jarvis.py`
- [Command routing](https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/blob/main/Jarvis/jarvis.py): `Jarvis/jarvis.py`
- [Language and speech](https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/blob/main/Jarvis/jarvis.py): `Jarvis/jarvis.py`

### Command features

- [Greetings](https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/blob/main/Jarvis/jarvis.py): `Jarvis/jarvis.py`
- [Time and date](https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/blob/main/Jarvis/jarvis.py): `Jarvis/jarvis.py`
- [Web shortcuts](https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/blob/main/Jarvis/jarvis.py): `Jarvis/jarvis.py`
- [Wikipedia search](https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/blob/main/Jarvis/jarvis.py): `Jarvis/jarvis.py`
- [Music playback](https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/blob/main/Jarvis/jarvis.py): `Jarvis/jarvis.py`
- [Screenshots](https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/blob/main/Jarvis/jarvis.py): `Jarvis/jarvis.py`
- [Power controls](https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/blob/main/Jarvis/jarvis.py): `Jarvis/jarvis.py`
- [Notes, jokes, websites](https://github.com/kishanrajput23/jarvis-desktop-voice-assistant/tree/main/Jarvis): `Jarvis`

### Desktop and services

- **Speech recognition**
- **Local music library**
- **Desktop operating system**
- **Browser**
- **Wikipedia service**
- **Screenshot file**

### Other components

- **User**

## Connections

- User → Voice capture: speaks to (evidence: `Jarvis/jarvis.py`)
- Voice capture → Speech recognition: recognizes with (evidence: `Jarvis/jarvis.py`)
- Voice capture → Command routing: returns transcript (evidence: `Jarvis/jarvis.py`)
- Command routing → Greetings: calls at startup (evidence: `Jarvis/jarvis.py`)
- Command routing → Time and date: dispatches to (evidence: `Jarvis/jarvis.py`)
- Command routing → Web shortcuts: dispatches to (evidence: `Jarvis/jarvis.py`)
- Command routing → Wikipedia search: dispatches to (evidence: `Jarvis/jarvis.py`)
- Command routing → Music playback: dispatches to (evidence: `Jarvis/jarvis.py`)
- Command routing → Screenshots: dispatches to (evidence: `Jarvis/jarvis.py`)
- Command routing → Power controls: dispatches to (evidence: `Jarvis/jarvis.py`)
- Greetings → Language and speech: speaks greeting (evidence: `Jarvis/jarvis.py`)
- Time and date → Language and speech: speaks result (evidence: `Jarvis/jarvis.py`)
- Wikipedia search → Wikipedia service: requests summary (evidence: `Jarvis/jarvis.py`)
- Wikipedia search → Language and speech: speaks summary (evidence: `Jarvis/jarvis.py`)
- Music playback → Local music library: searches files (evidence: `Jarvis/jarvis.py`)
- Music playback → Desktop operating system: opens selected track (evidence: `Jarvis/jarvis.py`)
- Music playback → Language and speech: speaks status (evidence: `Jarvis/jarvis.py`)
- Web shortcuts → Browser: opens site (evidence: `Jarvis/jarvis.py`)
- Screenshots → Screenshot file: saves image (evidence: `Jarvis/jarvis.py`)
- Screenshots → Language and speech: speaks saved path (evidence: `Jarvis/jarvis.py`)
- Power controls → Desktop operating system: runs power command (evidence: `Jarvis/jarvis.py`)
- Power controls → Language and speech: speaks status (evidence: `Jarvis/jarvis.py`)
- Language and speech → User: speaks response (evidence: `Jarvis/jarvis.py`)
- Command routing → Notes, jokes, websites: documented capability (evidence: `README.md`)
