# aathifpm/jarvis architecture

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

- Interactive diagram: https://gitdiagram.com/aathifpm/jarvis
- Repository: https://github.com/aathifpm/jarvis

## Overview

Jarvis is a voice-operated personal assistant: a user speaks a request, the application listens and processes it, routes it to a response or skill, then speaks the result. Its documented capabilities also include alarms, calendar events, task management, live transcription, messaging, system control, and information lookup. The graph follows the sampled main loop and core dispatch where visible; some documented skills are included, but their routing is unverified in the available excerpts. The task manager persists tasks in JSON; other storage and integration details are not established here.

Main entry points: [`assistant/core.py`](https://github.com/aathifpm/jarvis/blob/main/assistant/core.py) (Assistant Runtime), [`main.py`](https://github.com/aathifpm/jarvis/blob/main/main.py) (Application Entry), [`assistant/speech.py`](https://github.com/aathifpm/jarvis/blob/main/assistant/speech.py) (Speech Handler), [`assistant/nlp.py`](https://github.com/aathifpm/jarvis/blob/main/assistant/nlp.py) (Command Processing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Voice Interaction"]
  node_entry["Application Entry<br/>[main.py]"]
  node_speech["Speech Handler<br/>[speech.py]"]
end

subgraph group_assistant["Assistant Core"]
  node_core["Assistant Runtime<br/>[core.py]"]
  node_nlp["Command Processing<br/>[nlp.py]"]
  node_context["Conversation Context<br/>[context_manager.py]"]
  node_profile["User Profile<br/>[user_profile.py]"]
  node_proactive["Proactive Assistance"]
end

subgraph group_skills["Assistant Skills"]
  node_tasks["Task Management<br/>[task_manager.py]"]
  node_alarms["Alarms And Reminders<br/>[alarm.py]"]
  node_calendar["Calendar Events"]
  node_system["System Control<br/>[system_control.py]"]
  node_transcription["Live Transcription"]
  node_whatsapp["WhatsApp Control"]
  node_weather["Weather<br/>[weather.py]"]
  node_time["Time And Date<br/>[time_date.py]"]
  node_websearch["Web Search<br/>[web_search.py]"]
end

subgraph group_support["State And Services"]
  node_taskstore[("Task Data<br/>[tasks.json]")]
  node_gemini["Gemini NLP Service<br/>[gemini_nlp.py]"]
  node_emotion["Emotion Detection"]
  node_errors["Error Handling<br/>[error_handler.py]"]
end

node_user(("User"))
node_weather_services["Weather Services"]
node_speech_services["Speech Recognition"]

node_user -->|"starts assistant"| node_entry
node_entry -->|"creates runtime"| node_core
node_core -->|"listens and speaks"| node_speech
node_speech -.->|"recognizes speech"| node_speech_services
node_core -->|"processes commands"| node_nlp
node_core -->|"uses context"| node_context
node_core -->|"uses profile"| node_profile
node_core -->|"starts assistance"| node_proactive
node_core -->|"uses manager"| node_tasks
node_tasks -->|"reads and writes"| node_taskstore
node_nlp -->|"requests responses"| node_gemini
node_core -->|"generates responses"| node_gemini
node_core -->|"detects emotion"| node_emotion
node_core -->|"wraps commands"| node_errors
node_core -->|"handles events"| node_calendar
node_core -->|"handles weather"| node_weather
node_core -->|"dispatches commands"| node_system
node_core -->|"dispatches transcription"| node_transcription
node_core -->|"dispatches messages"| node_whatsapp
node_core -.->|"supports reminders"| node_alarms
node_core -.->|"supports time queries"| node_time
node_core -.->|"supports lookup"| node_websearch
node_weather -.->|"fetches conditions"| node_weather_services

click node_entry "https://github.com/aathifpm/jarvis/blob/main/main.py"
click node_speech "https://github.com/aathifpm/jarvis/blob/main/assistant/speech.py"
click node_core "https://github.com/aathifpm/jarvis/blob/main/assistant/core.py"
click node_nlp "https://github.com/aathifpm/jarvis/blob/main/assistant/nlp.py"
click node_context "https://github.com/aathifpm/jarvis/blob/main/assistant/context_manager.py"
click node_profile "https://github.com/aathifpm/jarvis/blob/main/assistant/user_profile.py"
click node_proactive "https://github.com/aathifpm/jarvis/blob/main/assistant/proactive_assistant.py"
click node_tasks "https://github.com/aathifpm/jarvis/blob/main/assistant/task_manager.py"
click node_taskstore "https://github.com/aathifpm/jarvis/blob/main/data/tasks.json"
click node_alarms "https://github.com/aathifpm/jarvis/blob/main/skills/alarm.py"
click node_calendar "https://github.com/aathifpm/jarvis/blob/main/skills/calendar_integration.py"
click node_system "https://github.com/aathifpm/jarvis/blob/main/skills/system_control.py"
click node_transcription "https://github.com/aathifpm/jarvis/blob/main/skills/live_transcription.py"
click node_whatsapp "https://github.com/aathifpm/jarvis/blob/main/skills/whatsapp_control.py"
click node_weather "https://github.com/aathifpm/jarvis/blob/main/skills/weather.py"
click node_time "https://github.com/aathifpm/jarvis/blob/main/skills/time_date.py"
click node_websearch "https://github.com/aathifpm/jarvis/blob/main/skills/web_search.py"
click node_gemini "https://github.com/aathifpm/jarvis/blob/main/utils/gemini_nlp.py"
click node_emotion "https://github.com/aathifpm/jarvis/blob/main/utils/emotion_detector.py"
click node_errors "https://github.com/aathifpm/jarvis/blob/main/utils/error_handler.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_entry,node_speech,node_user toneBlue
class node_core,node_nlp,node_context,node_profile,node_proactive toneAmber
class node_tasks,node_alarms,node_calendar,node_system,node_transcription,node_whatsapp,node_weather,node_time,node_websearch toneMint
class node_taskstore,node_gemini,node_emotion,node_errors toneRose
class node_weather_services,node_speech_services toneIndigo
```

## Components

### Voice Interaction

- [Application Entry](https://github.com/aathifpm/jarvis/blob/main/main.py): `main.py`
- [Speech Handler](https://github.com/aathifpm/jarvis/blob/main/assistant/speech.py): `assistant/speech.py`

### Assistant Core

- [Assistant Runtime](https://github.com/aathifpm/jarvis/blob/main/assistant/core.py): `assistant/core.py`
- [Command Processing](https://github.com/aathifpm/jarvis/blob/main/assistant/nlp.py): `assistant/nlp.py`
- [Conversation Context](https://github.com/aathifpm/jarvis/blob/main/assistant/context_manager.py): `assistant/context_manager.py`
- [User Profile](https://github.com/aathifpm/jarvis/blob/main/assistant/user_profile.py): `assistant/user_profile.py`
- [Proactive Assistance](https://github.com/aathifpm/jarvis/blob/main/assistant/proactive_assistant.py): `assistant/proactive_assistant.py`

### Assistant Skills

- [Task Management](https://github.com/aathifpm/jarvis/blob/main/assistant/task_manager.py): `assistant/task_manager.py`
- [Alarms And Reminders](https://github.com/aathifpm/jarvis/blob/main/skills/alarm.py): `skills/alarm.py`
- [Calendar Events](https://github.com/aathifpm/jarvis/blob/main/skills/calendar_integration.py): `skills/calendar_integration.py`
- [System Control](https://github.com/aathifpm/jarvis/blob/main/skills/system_control.py): `skills/system_control.py`
- [Live Transcription](https://github.com/aathifpm/jarvis/blob/main/skills/live_transcription.py): `skills/live_transcription.py`
- [WhatsApp Control](https://github.com/aathifpm/jarvis/blob/main/skills/whatsapp_control.py): `skills/whatsapp_control.py`
- [Weather](https://github.com/aathifpm/jarvis/blob/main/skills/weather.py): `skills/weather.py`
- [Time And Date](https://github.com/aathifpm/jarvis/blob/main/skills/time_date.py): `skills/time_date.py`
- [Web Search](https://github.com/aathifpm/jarvis/blob/main/skills/web_search.py): `skills/web_search.py`

### State And Services

- [Task Data](https://github.com/aathifpm/jarvis/blob/main/data/tasks.json): `data/tasks.json`
- [Gemini NLP Service](https://github.com/aathifpm/jarvis/blob/main/utils/gemini_nlp.py): `utils/gemini_nlp.py`
- [Emotion Detection](https://github.com/aathifpm/jarvis/blob/main/utils/emotion_detector.py): `utils/emotion_detector.py`
- [Error Handling](https://github.com/aathifpm/jarvis/blob/main/utils/error_handler.py): `utils/error_handler.py`

### Other components

- **User**
- **Weather Services**
- **Speech Recognition**

## Connections

- User → Application Entry: starts assistant (evidence: `README.md`)
- Application Entry → Assistant Runtime: creates runtime (evidence: `main.py`)
- Assistant Runtime → Speech Handler: listens and speaks (evidence: `assistant/core.py`)
- Speech Handler → Speech Recognition: recognizes speech
- Assistant Runtime → Command Processing: processes commands (evidence: `assistant/core.py`)
- Assistant Runtime → Conversation Context: uses context (evidence: `assistant/core.py`)
- Assistant Runtime → User Profile: uses profile (evidence: `assistant/core.py`)
- Assistant Runtime → Proactive Assistance: starts assistance (evidence: `assistant/core.py`)
- Assistant Runtime → Task Management: uses manager (evidence: `assistant/core.py`)
- Task Management → Task Data: reads and writes (evidence: `assistant/task_manager.py`)
- Command Processing → Gemini NLP Service: requests responses (evidence: `assistant/nlp.py`)
- Assistant Runtime → Gemini NLP Service: generates responses (evidence: `assistant/core.py`)
- Assistant Runtime → Emotion Detection: detects emotion (evidence: `assistant/core.py`)
- Assistant Runtime → Error Handling: wraps commands (evidence: `assistant/core.py`)
- Assistant Runtime → Calendar Events: handles events (evidence: `assistant/core.py`)
- Assistant Runtime → Weather: handles weather (evidence: `assistant/core.py`)
- Assistant Runtime → System Control: dispatches commands (evidence: `assistant/core.py`)
- Assistant Runtime → Live Transcription: dispatches transcription (evidence: `assistant/core.py`)
- Assistant Runtime → WhatsApp Control: dispatches messages (evidence: `assistant/core.py`)
- Assistant Runtime → Alarms And Reminders: supports reminders
- Assistant Runtime → Time And Date: supports time queries
- Assistant Runtime → Web Search: supports lookup
- Weather → Weather Services: fetches conditions
