# nitintiwari20/jarvis-voice-assistant architecture

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

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

## Overview

JARVIS is a voice-first personal assistant with CLI and web HUD interfaces. Its main workflow accepts spoken or typed commands, classifies intent, dispatches a specialized tool, and presents the result as text and optionally speech. The tools cover lookup, calculations, system control, messaging, email, and reminders; reminders have documented persistent storage. The excerpts show concrete wiring for several tools and both interfaces. Other tool dispatches and the web HUD’s browser-side behavior are represented from README documentation, not inspected source.

Main entry points: [`jarvis_brain.py`](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/jarvis_brain.py) (Intent Brain), [`main.py`](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/main.py) (CLI Loop), [`server.py`](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/server.py) (Web Server), [`templates/index.html`](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/templates/index.html) (HUD Page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User Interfaces"]
  node_cli["CLI Loop<br/>[main.py]"]
  node_webhud["Web HUD<br/>[app.js]"]
  node_webpage["HUD Page<br/>[index.html]"]
  node_server["Web Server<br/>[server.py]"]
end

subgraph group_orchestration["Command Orchestration"]
  node_brain["Intent Brain<br/>[jarvis_brain.py]"]
  node_config["Assistant Config<br/>[config.py]"]
end

subgraph group_speech["Speech I/O"]
  node_stt["Speech Recognition<br/>[stt_engine.py]"]
  node_tts["Speech Synthesis<br/>[tts_engine.py]"]
end

subgraph group_information["Information Tools"]
  node_websearch["Web Search<br/>[web_search.py]"]
  node_prices["Price Search<br/>[price_search.py]"]
  node_wikipedia["Wikipedia Lookup<br/>[wikipedia.py]"]
  node_weather["Weather Lookup<br/>[weather.py]"]
  node_calculator["Calculator<br/>[calculator.py]"]
  node_github["GitHub Lookup<br/>[github.py]"]
end

subgraph group_actions["Actions and State"]
  node_system["System Control<br/>[system_tools.py]"]
  node_whatsapp["WhatsApp Actions<br/>[whatsapp.py]"]
  node_email["Email Drafting<br/>[email.py]"]
  node_reminders["Reminder Manager<br/>[reminders.py]"]
  node_reminderstore[("Reminder Store<br/>[reminders.json]")]
end

node_user(("User"))

node_user -->|"enters command"| node_cli
node_user -->|"enters command"| node_webhud
node_cli -->|"listens via"| node_stt
node_cli -->|"submits command"| node_brain
node_cli -->|"speaks result"| node_tts
node_webhud -.->|"renders"| node_webpage
node_webpage -.->|"uses API"| node_server
node_server -->|"submits command"| node_brain
node_server -->|"optionally speaks"| node_tts
node_server -->|"serves page"| node_webpage
node_brain -->|"loads settings"| node_config
node_brain -->|"dispatches"| node_whatsapp
node_brain -->|"dispatches"| node_weather
node_brain -->|"dispatches"| node_calculator
node_brain -->|"dispatches"| node_system
node_brain -->|"dispatches"| node_reminders
node_brain -->|"dispatches"| node_websearch
node_brain -->|"dispatches"| node_prices
node_brain -->|"dispatches"| node_wikipedia
node_brain -->|"dispatches"| node_github
node_brain -->|"dispatches"| node_email
node_reminders -->|"persists reminders"| node_reminderstore

click node_cli "https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/main.py"
click node_webhud "https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/static/app.js"
click node_webpage "https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/templates/index.html"
click node_server "https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/server.py"
click node_brain "https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/jarvis_brain.py"
click node_config "https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/config.py"
click node_stt "https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/stt_engine.py"
click node_tts "https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/tts_engine.py"
click node_websearch "https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/Voicetools/web_search.py"
click node_prices "https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/Voicetools/price_search.py"
click node_wikipedia "https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/Voicetools/wikipedia.py"
click node_weather "https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/Voicetools/weather.py"
click node_calculator "https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/Voicetools/calculator.py"
click node_github "https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/Voicetools/github.py"
click node_system "https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/Voicetools/system_tools.py"
click node_whatsapp "https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/Voicetools/whatsapp.py"
click node_email "https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/Voicetools/email.py"
click node_reminders "https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/Voicetools/reminders.py"
click node_reminderstore "https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/reminders.json"

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_cli,node_webhud,node_webpage,node_server,node_user toneBlue
class node_brain,node_config toneAmber
class node_stt,node_tts toneMint
class node_websearch,node_prices,node_wikipedia,node_weather,node_calculator,node_github toneRose
class node_system,node_whatsapp,node_email,node_reminders,node_reminderstore toneIndigo
```

## Components

### User Interfaces

- [CLI Loop](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/main.py): `main.py`
- [Web HUD](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/static/app.js): `static/app.js`
- [HUD Page](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/templates/index.html): `templates/index.html`
- [Web Server](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/server.py): `server.py`

### Command Orchestration

- [Intent Brain](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/jarvis_brain.py): `jarvis_brain.py`
- [Assistant Config](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/config.py): `config.py`

### Speech I/O

- [Speech Recognition](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/stt_engine.py): `stt_engine.py`
- [Speech Synthesis](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/tts_engine.py): `tts_engine.py`

### Information Tools

- [Web Search](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/Voicetools/web_search.py): `Voicetools/web_search.py`
- [Price Search](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/Voicetools/price_search.py): `Voicetools/price_search.py`
- [Wikipedia Lookup](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/Voicetools/wikipedia.py): `Voicetools/wikipedia.py`
- [Weather Lookup](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/Voicetools/weather.py): `Voicetools/weather.py`
- [Calculator](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/Voicetools/calculator.py): `Voicetools/calculator.py`
- [GitHub Lookup](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/Voicetools/github.py): `Voicetools/github.py`

### Actions and State

- [System Control](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/Voicetools/system_tools.py): `Voicetools/system_tools.py`
- [WhatsApp Actions](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/Voicetools/whatsapp.py): `Voicetools/whatsapp.py`
- [Email Drafting](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/Voicetools/email.py): `Voicetools/email.py`
- [Reminder Manager](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/Voicetools/reminders.py): `Voicetools/reminders.py`
- [Reminder Store](https://github.com/nitintiwari20/jarvis-voice-assistant/blob/main/reminders.json): `reminders.json`

### Other components

- **User**

## Connections

- User → CLI Loop: enters command (evidence: `README.md`)
- User → Web HUD: enters command (evidence: `README.md`)
- CLI Loop → Speech Recognition: listens via (evidence: `main.py`)
- CLI Loop → Intent Brain: submits command (evidence: `main.py`)
- CLI Loop → Speech Synthesis: speaks result (evidence: `main.py`)
- Web HUD → HUD Page: renders
- HUD Page → Web Server: uses API
- Web Server → Intent Brain: submits command (evidence: `server.py`)
- Web Server → Speech Synthesis: optionally speaks (evidence: `server.py`)
- Web Server → HUD Page: serves page (evidence: `server.py`)
- Intent Brain → Assistant Config: loads settings (evidence: `jarvis_brain.py`)
- Intent Brain → WhatsApp Actions: dispatches (evidence: `jarvis_brain.py`)
- Intent Brain → Weather Lookup: dispatches (evidence: `jarvis_brain.py`)
- Intent Brain → Calculator: dispatches (evidence: `jarvis_brain.py`)
- Intent Brain → System Control: dispatches (evidence: `jarvis_brain.py`)
- Intent Brain → Reminder Manager: dispatches (evidence: `jarvis_brain.py`)
- Intent Brain → Web Search: dispatches (evidence: `jarvis_brain.py`)
- Intent Brain → Price Search: dispatches (evidence: `README.md`)
- Intent Brain → Wikipedia Lookup: dispatches (evidence: `README.md`)
- Intent Brain → GitHub Lookup: dispatches (evidence: `README.md`)
- Intent Brain → Email Drafting: dispatches (evidence: `README.md`)
- Reminder Manager → Reminder Store: persists reminders (evidence: `README.md`)
