# sajinstalin01/jarvis-ai architecture

> Architecture diagram of the GitHub repository sajinstalin01/jarvis-ai, 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/sajinstalin01/jarvis-ai
- Repository: https://github.com/sajinstalin01/jarvis-ai

## Overview

J.A.R.V.I.S. is a Windows-focused desktop assistant. The principal workflow runs from the desktop UI into command handling, which can produce AI replies, local actions, or permission-gated PC operations. The repository also provides voice interaction, remote control, local feature tools, settings, and system monitoring. The README documents several capabilities whose implementation was not sampled; those are represented at subsystem level with cautious, unverified links. Edges cite only visible imports or README statements.

Main entry points: [`ui.py`](https://github.com/sajinstalin01/jarvis-ai/blob/main/ui.py) (Desktop HUD), [`jarvis.py`](https://github.com/sajinstalin01/jarvis-ai/blob/main/jarvis.py) (Application entry), [`jarvis_legacy.py`](https://github.com/sajinstalin01/jarvis-ai/blob/main/jarvis_legacy.py) (Command handling), [`features/hub.py`](https://github.com/sajinstalin01/jarvis-ai/blob/main/features/hub.py) (Feature hub)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Desktop experience"]
  node_desktop["Desktop HUD<br/>[ui.py]"]
  node_font["Font collection<br/>[font_manager.py]"]
  node_settings["Settings hub<br/>[settings_hub.py]"]
end

subgraph group_assistant["Assistant runtime"]
  node_entry["Application entry<br/>[jarvis.py]"]
  node_commands["Command handling<br/>[jarvis_legacy.py]"]
  node_ai["AI responses<br/>[jarvis_ai.py]"]
  node_voice["Voice interaction<br/>[voice_control.py]"]
end

subgraph group_actions["Actions and control"]
  node_app_launch["App and site launch<br/>[open_command.py]"]
  node_pc["PC operations<br/>[pc_operator.py]"]
  node_permissions[("Action permissions<br/>[app_permissions.py]")]
  node_remote["Remote control<br/>[jarvis_remote.py]"]
end

subgraph group_features["Local features"]
  node_feature_hub["Feature hub<br/>[hub.py]"]
  node_files["File operations<br/>[file_manager.py]"]
  node_watch[("System monitoring<br/>[system_watch.py]")]
  node_integrations["Device integrations"]
end

subgraph group_state["Settings and state"]
  node_keys["API key management<br/>[api_key_manager.py]"]
  node_memory[("Conversation and memory<br/>[jarvis_services.py]")]
  node_preferences[("UI preferences<br/>[config_manager.py]")]
end

node_user(("User"))
node_external_apps(("Desktop apps and sites"))
node_remote_client(("Remote client"))
node_ai_provider(("Groq / Gemini"))

node_user -->|"uses"| node_desktop
node_desktop -.->|"starts"| node_entry
node_entry -->|"builds UI"| node_desktop
node_entry -->|"integrates"| node_commands
node_entry -->|"integrates"| node_font
node_entry -->|"integrates"| node_feature_hub
node_entry -->|"integrates"| node_pc
node_entry -->|"integrates"| node_remote
node_entry -->|"integrates"| node_integrations
node_commands -->|"requests replies"| node_ai
node_commands -->|"stores history"| node_memory
node_commands -.->|"launches"| node_app_launch
node_commands -.->|"dispatches actions"| node_pc
node_commands -->|"dispatches requests"| node_remote
node_commands -.->|"routes features"| node_feature_hub
node_ai -->|"uses credentials"| node_keys
node_ai -.->|"requests completions"| node_ai_provider
node_ai -.->|"uses saved context"| node_memory
node_voice -.->|"submits speech"| node_commands
node_feature_hub -->|"uses file tools"| node_files
node_feature_hub -->|"uses monitoring"| node_watch
node_feature_hub -->|"reads settings"| node_preferences
node_desktop -->|"opens settings"| node_settings
node_desktop -->|"reads preferences"| node_preferences
node_desktop -->|"shows memories"| node_memory
node_desktop -.->|"supports voice"| node_voice
node_desktop -.->|"shows telemetry"| node_watch
node_font -->|"registers fonts"| node_desktop
node_pc -.->|"requires authorization"| node_permissions
node_app_launch -.->|"hands off launch"| node_external_apps
node_remote_client -.->|"sends commands"| node_remote

click node_desktop "https://github.com/sajinstalin01/jarvis-ai/blob/main/ui.py"
click node_font "https://github.com/sajinstalin01/jarvis-ai/blob/main/font_manager.py"
click node_settings "https://github.com/sajinstalin01/jarvis-ai/blob/main/settings_hub.py"
click node_entry "https://github.com/sajinstalin01/jarvis-ai/blob/main/jarvis.py"
click node_commands "https://github.com/sajinstalin01/jarvis-ai/blob/main/jarvis_legacy.py"
click node_ai "https://github.com/sajinstalin01/jarvis-ai/blob/main/jarvis_ai.py"
click node_keys "https://github.com/sajinstalin01/jarvis-ai/blob/main/core/api_key_manager.py"
click node_voice "https://github.com/sajinstalin01/jarvis-ai/blob/main/voice_control.py"
click node_memory "https://github.com/sajinstalin01/jarvis-ai/blob/main/jarvis_services.py"
click node_preferences "https://github.com/sajinstalin01/jarvis-ai/blob/main/memory/config_manager.py"
click node_app_launch "https://github.com/sajinstalin01/jarvis-ai/blob/main/open_command.py"
click node_pc "https://github.com/sajinstalin01/jarvis-ai/blob/main/pc_operator.py"
click node_permissions "https://github.com/sajinstalin01/jarvis-ai/blob/main/app_permissions.py"
click node_remote "https://github.com/sajinstalin01/jarvis-ai/blob/main/jarvis_remote.py"
click node_feature_hub "https://github.com/sajinstalin01/jarvis-ai/blob/main/features/hub.py"
click node_files "https://github.com/sajinstalin01/jarvis-ai/blob/main/features/file_manager.py"
click node_watch "https://github.com/sajinstalin01/jarvis-ai/blob/main/features/system_watch.py"
click node_integrations "https://github.com/sajinstalin01/jarvis-ai/blob/main/features/device_integrations.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_desktop,node_font,node_settings,node_user,node_remote_client toneBlue
class node_entry,node_commands,node_ai,node_voice toneAmber
class node_app_launch,node_pc,node_permissions,node_remote toneMint
class node_feature_hub,node_files,node_watch,node_integrations toneRose
class node_keys,node_memory,node_preferences,node_external_apps,node_ai_provider toneIndigo
```

## Components

### Desktop experience

- [Desktop HUD](https://github.com/sajinstalin01/jarvis-ai/blob/main/ui.py): `ui.py`
- [Font collection](https://github.com/sajinstalin01/jarvis-ai/blob/main/font_manager.py): `font_manager.py`
- [Settings hub](https://github.com/sajinstalin01/jarvis-ai/blob/main/settings_hub.py): `settings_hub.py`

### Assistant runtime

- [Application entry](https://github.com/sajinstalin01/jarvis-ai/blob/main/jarvis.py): `jarvis.py`
- [Command handling](https://github.com/sajinstalin01/jarvis-ai/blob/main/jarvis_legacy.py): `jarvis_legacy.py`
- [AI responses](https://github.com/sajinstalin01/jarvis-ai/blob/main/jarvis_ai.py): `jarvis_ai.py`
- [Voice interaction](https://github.com/sajinstalin01/jarvis-ai/blob/main/voice_control.py): `voice_control.py`

### Actions and control

- [App and site launch](https://github.com/sajinstalin01/jarvis-ai/blob/main/open_command.py): `open_command.py`
- [PC operations](https://github.com/sajinstalin01/jarvis-ai/blob/main/pc_operator.py): `pc_operator.py`
- [Action permissions](https://github.com/sajinstalin01/jarvis-ai/blob/main/app_permissions.py): `app_permissions.py`
- [Remote control](https://github.com/sajinstalin01/jarvis-ai/blob/main/jarvis_remote.py): `jarvis_remote.py`

### Local features

- [Feature hub](https://github.com/sajinstalin01/jarvis-ai/blob/main/features/hub.py): `features/hub.py`
- [File operations](https://github.com/sajinstalin01/jarvis-ai/blob/main/features/file_manager.py): `features/file_manager.py`
- [System monitoring](https://github.com/sajinstalin01/jarvis-ai/blob/main/features/system_watch.py): `features/system_watch.py`
- [Device integrations](https://github.com/sajinstalin01/jarvis-ai/blob/main/features/device_integrations.py): `features/device_integrations.py`

### Settings and state

- [API key management](https://github.com/sajinstalin01/jarvis-ai/blob/main/core/api_key_manager.py): `core/api_key_manager.py`
- [Conversation and memory](https://github.com/sajinstalin01/jarvis-ai/blob/main/jarvis_services.py): `jarvis_services.py`
- [UI preferences](https://github.com/sajinstalin01/jarvis-ai/blob/main/memory/config_manager.py): `memory/config_manager.py`

### Other components

- **User**
- **Desktop apps and sites**
- **Remote client**
- **Groq / Gemini**

## Connections

- User → Desktop HUD: uses
- Desktop HUD → Application entry: starts (evidence: `jarvis.py`)
- Application entry → Desktop HUD: builds UI (evidence: `jarvis.py`)
- Application entry → Command handling: integrates (evidence: `jarvis.py`)
- Application entry → Font collection: integrates (evidence: `jarvis.py`)
- Application entry → Feature hub: integrates (evidence: `jarvis.py`)
- Application entry → PC operations: integrates (evidence: `jarvis.py`)
- Application entry → Remote control: integrates (evidence: `jarvis.py`)
- Application entry → Device integrations: integrates (evidence: `jarvis.py`)
- Command handling → AI responses: requests replies (evidence: `jarvis_legacy.py`)
- Command handling → Conversation and memory: stores history (evidence: `jarvis_legacy.py`)
- Command handling → App and site launch: launches
- Command handling → PC operations: dispatches actions
- Command handling → Remote control: dispatches requests (evidence: `jarvis_legacy.py`)
- Command handling → Feature hub: routes features
- AI responses → API key management: uses credentials (evidence: `jarvis_ai.py`)
- AI responses → Groq / Gemini: requests completions
- AI responses → Conversation and memory: uses saved context
- Voice interaction → Command handling: submits speech
- Feature hub → File operations: uses file tools (evidence: `features/hub.py`)
- Feature hub → System monitoring: uses monitoring (evidence: `features/hub.py`)
- Feature hub → UI preferences: reads settings (evidence: `features/hub.py`)
- Desktop HUD → Settings hub: opens settings (evidence: `ui.py`)
- Desktop HUD → UI preferences: reads preferences (evidence: `ui.py`)
- Desktop HUD → Conversation and memory: shows memories (evidence: `ui.py`)
- Desktop HUD → Voice interaction: supports voice
- Desktop HUD → System monitoring: shows telemetry
- Font collection → Desktop HUD: registers fonts (evidence: `font_manager.py`)
- PC operations → Action permissions: requires authorization
- App and site launch → Desktop apps and sites: hands off launch
- Remote client → Remote control: sends commands
