# deestudio028-droid/jarvis architecture

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

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

## Overview

JARVIS is a multimodal personal assistant whose main workflow runs from user input through a live assistant session, model/tool handling, and spoken or visual results. It also offers a separately runnable WhatsApp voice-call bridge, desktop and system automation, plugins, persistent memory, and a local HTTP dashboard. The README documents Gemini Live and offline/local intelligence; sampled excerpts do not show every runtime route, so some major capabilities are represented at subsystem level. Edges reflect documented statements or visible references and calls, not assumed sequencing.

Main entry points: [`main.py`](https://github.com/deestudio028-droid/jarvis/blob/main/main.py) (Live Assistant), [`live_test_bridge.py`](https://github.com/deestudio028-droid/jarvis/blob/main/live_test_bridge.py) (Voice Bridge Runner), [`plugins/whatsapp_voice_bridge.py`](https://github.com/deestudio028-droid/jarvis/blob/main/plugins/whatsapp_voice_bridge.py) (WhatsApp Voice Bridge), [`core/llm_client.py`](https://github.com/deestudio028-droid/jarvis/blob/main/core/llm_client.py) (LLM Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_assistant["Assistant Runtime"]
  node_main["Live Assistant<br/>[main.py]"]
  node_hud["HUD Interface<br/>[ui.py]"]
  node_dashboard["HTTP Dashboard<br/>[server.py]"]
end

subgraph group_intelligence["Intelligence &amp; I/O"]
  node_llm["LLM Client<br/>[llm_client.py]"]
  node_stt["Speech Recognition<br/>[stt.py]"]
  node_tts["Speech Synthesis<br/>[tts.py]"]
end

subgraph group_automation["Automation Skills"]
  node_browser["Browser Control<br/>[browser_control.py]"]
  node_computer["Computer Settings"]
  node_dev_agent["Development Agent<br/>[dev_agent.py]"]
  node_file_processor["File Processing<br/>[file_processor.py]"]
  node_file_controller["File Operations<br/>[file_controller.py]"]
  node_web_search["Web Search<br/>[web_search.py]"]
  node_game_updater["Game Updater<br/>[game_updater.py]"]
  node_other_skills["Other Assistant Skills"]
end

subgraph group_communications["Communications &amp; Plugins"]
  node_plugin_loader["Plugin Discovery<br/>[plugin_loader.py]"]
  node_live_runner["Voice Bridge Runner"]
  node_voice_bridge["WhatsApp Voice Bridge"]
  node_whatsapp_call["WhatsApp Desktop Calls"]
  node_monitor["WhatsApp Monitor"]
  node_drone["Drone Control<br/>[ky_ufo_drone.py]"]
end

subgraph group_state["Configuration &amp; State"]
  node_memory[("Conversation Memory<br/>[memory_manager.py]")]
  node_config[("Settings<br/>[config_manager.py]")]
end

node_user(("User"))
node_ollama(("Ollama Service"))
node_whatsapp(("WhatsApp Desktop"))

node_user -->|"starts session"| node_main
node_main -->|"launches interface"| node_hud
node_main -->|"requests responses"| node_llm
node_main -->|"loads context"| node_memory
node_main -->|"dispatches tools"| node_browser
node_main -->|"dispatches tools"| node_computer
node_main -->|"dispatches tools"| node_dev_agent
node_main -->|"dispatches tools"| node_file_processor
node_main -->|"dispatches tools"| node_file_controller
node_main -->|"dispatches tools"| node_web_search
node_main -->|"dispatches tools"| node_game_updater
node_main -->|"dispatches tools"| node_other_skills
node_main -.->|"uses speech input"| node_stt
node_main -.->|"uses speech output"| node_tts
node_user -->|"sends commands"| node_dashboard
node_dashboard -.->|"queues commands"| node_main
node_live_runner -->|"runs bridge"| node_voice_bridge
node_live_runner -->|"uses transcription"| node_stt
node_live_runner -->|"requests responses"| node_llm
node_live_runner -->|"speaks replies"| node_tts
node_voice_bridge -->|"starts calls"| node_whatsapp_call
node_voice_bridge -->|"generates replies"| node_llm
node_voice_bridge -->|"speaks replies"| node_tts
node_whatsapp_call -->|"controls desktop"| node_whatsapp
node_plugin_loader -->|"checks settings"| node_config
node_monitor -->|"sends messages"| node_other_skills
node_ollama -->|"serves model requests"| node_llm
node_main -.->|"loads plugins"| node_plugin_loader

click node_main "https://github.com/deestudio028-droid/jarvis/blob/main/main.py"
click node_hud "https://github.com/deestudio028-droid/jarvis/blob/main/ui.py"
click node_dashboard "https://github.com/deestudio028-droid/jarvis/blob/main/dashboard/server.py"
click node_llm "https://github.com/deestudio028-droid/jarvis/blob/main/core/llm_client.py"
click node_stt "https://github.com/deestudio028-droid/jarvis/blob/main/core/stt.py"
click node_tts "https://github.com/deestudio028-droid/jarvis/blob/main/core/tts.py"
click node_memory "https://github.com/deestudio028-droid/jarvis/blob/main/memory/memory_manager.py"
click node_config "https://github.com/deestudio028-droid/jarvis/blob/main/memory/config_manager.py"
click node_plugin_loader "https://github.com/deestudio028-droid/jarvis/blob/main/core/plugin_loader.py"
click node_browser "https://github.com/deestudio028-droid/jarvis/blob/main/actions/browser_control.py"
click node_computer "https://github.com/deestudio028-droid/jarvis/blob/main/actions/computer_settings.py"
click node_dev_agent "https://github.com/deestudio028-droid/jarvis/blob/main/actions/dev_agent.py"
click node_file_processor "https://github.com/deestudio028-droid/jarvis/blob/main/actions/file_processor.py"
click node_file_controller "https://github.com/deestudio028-droid/jarvis/blob/main/actions/file_controller.py"
click node_web_search "https://github.com/deestudio028-droid/jarvis/blob/main/actions/web_search.py"
click node_game_updater "https://github.com/deestudio028-droid/jarvis/blob/main/actions/game_updater.py"
click node_other_skills "https://github.com/deestudio028-droid/jarvis/tree/main/actions"
click node_live_runner "https://github.com/deestudio028-droid/jarvis/blob/main/live_test_bridge.py"
click node_voice_bridge "https://github.com/deestudio028-droid/jarvis/blob/main/plugins/whatsapp_voice_bridge.py"
click node_whatsapp_call "https://github.com/deestudio028-droid/jarvis/blob/main/plugins/whatsapp_desktop_call.py"
click node_monitor "https://github.com/deestudio028-droid/jarvis/blob/main/plugins/whatsapp_monitor.py"
click node_drone "https://github.com/deestudio028-droid/jarvis/blob/main/plugins/ky_ufo_drone.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_main,node_hud,node_dashboard,node_user toneBlue
class node_llm,node_stt,node_tts toneAmber
class node_browser,node_computer,node_dev_agent,node_file_processor,node_file_controller,node_web_search,node_game_updater,node_other_skills toneMint
class node_plugin_loader,node_live_runner,node_voice_bridge,node_whatsapp_call,node_monitor,node_drone toneRose
class node_memory,node_config,node_ollama,node_whatsapp toneIndigo
```

## Components

### Assistant Runtime

- [Live Assistant](https://github.com/deestudio028-droid/jarvis/blob/main/main.py): `main.py`
- [HUD Interface](https://github.com/deestudio028-droid/jarvis/blob/main/ui.py): `ui.py`
- [HTTP Dashboard](https://github.com/deestudio028-droid/jarvis/blob/main/dashboard/server.py): `dashboard/server.py`

### Intelligence & I/O

- [LLM Client](https://github.com/deestudio028-droid/jarvis/blob/main/core/llm_client.py): `core/llm_client.py`
- [Speech Recognition](https://github.com/deestudio028-droid/jarvis/blob/main/core/stt.py): `core/stt.py`
- [Speech Synthesis](https://github.com/deestudio028-droid/jarvis/blob/main/core/tts.py): `core/tts.py`

### Automation Skills

- [Browser Control](https://github.com/deestudio028-droid/jarvis/blob/main/actions/browser_control.py): `actions/browser_control.py`
- [Computer Settings](https://github.com/deestudio028-droid/jarvis/blob/main/actions/computer_settings.py): `actions/computer_settings.py`
- [Development Agent](https://github.com/deestudio028-droid/jarvis/blob/main/actions/dev_agent.py): `actions/dev_agent.py`
- [File Processing](https://github.com/deestudio028-droid/jarvis/blob/main/actions/file_processor.py): `actions/file_processor.py`
- [File Operations](https://github.com/deestudio028-droid/jarvis/blob/main/actions/file_controller.py): `actions/file_controller.py`
- [Web Search](https://github.com/deestudio028-droid/jarvis/blob/main/actions/web_search.py): `actions/web_search.py`
- [Game Updater](https://github.com/deestudio028-droid/jarvis/blob/main/actions/game_updater.py): `actions/game_updater.py`
- [Other Assistant Skills](https://github.com/deestudio028-droid/jarvis/tree/main/actions): `actions`

### Communications & Plugins

- [Plugin Discovery](https://github.com/deestudio028-droid/jarvis/blob/main/core/plugin_loader.py): `core/plugin_loader.py`
- [Voice Bridge Runner](https://github.com/deestudio028-droid/jarvis/blob/main/live_test_bridge.py): `live_test_bridge.py`
- [WhatsApp Voice Bridge](https://github.com/deestudio028-droid/jarvis/blob/main/plugins/whatsapp_voice_bridge.py): `plugins/whatsapp_voice_bridge.py`
- [WhatsApp Desktop Calls](https://github.com/deestudio028-droid/jarvis/blob/main/plugins/whatsapp_desktop_call.py): `plugins/whatsapp_desktop_call.py`
- [WhatsApp Monitor](https://github.com/deestudio028-droid/jarvis/blob/main/plugins/whatsapp_monitor.py): `plugins/whatsapp_monitor.py`
- [Drone Control](https://github.com/deestudio028-droid/jarvis/blob/main/plugins/ky_ufo_drone.py): `plugins/ky_ufo_drone.py`

### Configuration & State

- [Conversation Memory](https://github.com/deestudio028-droid/jarvis/blob/main/memory/memory_manager.py): `memory/memory_manager.py`
- [Settings](https://github.com/deestudio028-droid/jarvis/blob/main/memory/config_manager.py): `memory/config_manager.py`

### Other components

- **User**
- **Ollama Service**
- **WhatsApp Desktop**

## Connections

- User → Live Assistant: starts session
- Live Assistant → HUD Interface: launches interface (evidence: `main.py`)
- Live Assistant → LLM Client: requests responses (evidence: `main.py`)
- Live Assistant → Conversation Memory: loads context (evidence: `main.py`)
- Live Assistant → Browser Control: dispatches tools (evidence: `main.py`)
- Live Assistant → Computer Settings: dispatches tools (evidence: `main.py`)
- Live Assistant → Development Agent: dispatches tools (evidence: `main.py`)
- Live Assistant → File Processing: dispatches tools (evidence: `main.py`)
- Live Assistant → File Operations: dispatches tools (evidence: `main.py`)
- Live Assistant → Web Search: dispatches tools (evidence: `main.py`)
- Live Assistant → Game Updater: dispatches tools (evidence: `main.py`)
- Live Assistant → Other Assistant Skills: dispatches tools (evidence: `main.py`)
- Live Assistant → Speech Recognition: uses speech input
- Live Assistant → Speech Synthesis: uses speech output
- User → HTTP Dashboard: sends commands (evidence: `dashboard/server.py`)
- HTTP Dashboard → Live Assistant: queues commands (evidence: `main.py`)
- Voice Bridge Runner → WhatsApp Voice Bridge: runs bridge (evidence: `live_test_bridge.py`)
- Voice Bridge Runner → Speech Recognition: uses transcription (evidence: `live_test_bridge.py`)
- Voice Bridge Runner → LLM Client: requests responses (evidence: `live_test_bridge.py`)
- Voice Bridge Runner → Speech Synthesis: speaks replies (evidence: `live_test_bridge.py`)
- WhatsApp Voice Bridge → WhatsApp Desktop Calls: starts calls (evidence: `plugins/whatsapp_voice_bridge.py`)
- WhatsApp Voice Bridge → LLM Client: generates replies (evidence: `plugins/whatsapp_voice_bridge.py`)
- WhatsApp Voice Bridge → Speech Synthesis: speaks replies (evidence: `plugins/whatsapp_voice_bridge.py`)
- WhatsApp Desktop Calls → WhatsApp Desktop: controls desktop (evidence: `plugins/whatsapp_desktop_call.py`)
- Plugin Discovery → Settings: checks settings (evidence: `core/plugin_loader.py`)
- WhatsApp Monitor → Other Assistant Skills: sends messages (evidence: `plugins/whatsapp_monitor.py`)
- Ollama Service → LLM Client: serves model requests
- Live Assistant → Plugin Discovery: loads plugins (evidence: `main.py`)
