# mdpwbe-sys/jarvis.package architecture

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

## Overview

J.A.R.V.I.S. is a local-first assistant suite: users submit requests through its API or desktop chat, the backend dispatches work to agents and machine-control capabilities, and clients display results or telemetry. The graph also retains documented KVM, security, document-generation, and desktop/mobile capabilities. Source evidence is partial; unsampled subsystems are represented only where the README or SOURCE INDEX supports their role, and unsupported internal links are omitted.

Main entry points: [`server.py`](https://github.com/mdpwbe-sys/jarvis.package/blob/main/server.py) (API server), [`modules/dispatcher.py`](https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/dispatcher.py) (Request dispatcher), [`modules/conversation.py`](https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/conversation.py) (Conversation handling), [`modules/session.py`](https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/session.py) (Session archive)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_backend["Backend orchestration"]
  node_server["API server<br/>[server.py]"]
  node_dispatcher["Request dispatcher<br/>[dispatcher.py]"]
  node_conversation["Conversation handling<br/>[conversation.py]"]
  node_sessions["Session archive<br/>[session.py]"]
  node_memory[("Persistent memory<br/>[memory.py]")]
  node_config["Configuration<br/>[config.py]"]
end

subgraph group_knowledge["Knowledge and agents"]
  node_agents["AI agents"]
  node_skills["Skills discovery<br/>[skills_manager.py]"]
  node_web["Web research<br/>[scraper.py]"]
  node_notebook["Document notebook<br/>[notebook_engine.py]"]
  node_extractor["Document extraction<br/>[pdf_engine.py]"]
  node_gemini["Gemini generation<br/>[gemini_engine.py]"]
end

subgraph group_machine["Machine capabilities"]
  node_dashboardfeed["Dashboard telemetry<br/>[dashboard_feed.py]"]
  node_kvm["KVM control<br/>[kvm.py]"]
  node_security["Security controls<br/>[security_guard.py]"]
  node_documents["Document generation<br/>[doc_builder.py]"]
  node_oi["Machine operations<br/>[oi.py]"]
end

subgraph group_desktop["Desktop client"]
  node_desktopmain["Desktop runtime<br/>[main.js]"]
  node_bridge["System telemetry bridge<br/>[systemBridge.js]"]
  node_desktopui["Desktop interface<br/>[App.jsx]"]
  node_dashboard["Dashboard view<br/>[Dashboard.jsx]"]
  node_terminal["Terminal view<br/>[TerminalView.jsx]"]
  node_chat["Chat view<br/>[ChatView.jsx]"]
end

subgraph group_mobile["Mobile client"]
  node_mobile["iOS KVM client<br/>[App.js]"]
  node_kvmhtml["KVM web templates<br/>[HtmlTemplates.js]"]
end

node_user(("User"))
node_ollama{{"Local Ollama"}}

node_user -->|"submits requests"| node_server
node_server -->|"dispatches requests"| node_dispatcher
node_server -->|"routes conversation"| node_conversation
node_server -->|"manages sessions"| node_sessions
node_server -->|"reads and saves"| node_memory
node_server -->|"routes KVM control"| node_kvm
node_server -->|"serves telemetry"| node_dashboardfeed
node_server -->|"uses security controls"| node_security
node_dispatcher -->|"delegates requests"| node_conversation
node_dispatcher -->|"uses persistent memory"| node_memory
node_dispatcher -->|"loads skills"| node_skills
node_dispatcher -->|"uses web research"| node_web
node_dispatcher -->|"routes operations"| node_oi
node_dispatcher -->|"routes agent tasks"| node_agents
node_conversation -->|"reads and updates"| node_memory
node_conversation -->|"uses session handling"| node_sessions
node_sessions -->|"persists session state"| node_memory
node_sessions -->|"requests titles"| node_ollama
node_notebook -->|"extracts source text"| node_extractor
node_notebook -->|"sends grounded questions"| node_gemini
node_desktopmain -->|"starts telemetry bridge"| node_bridge
node_desktopmain -->|"starts backend process"| node_server
node_desktopui -->|"renders dashboard"| node_dashboard
node_desktopui -->|"renders terminal"| node_terminal
node_desktopui -->|"renders chat"| node_chat
node_mobile -->|"builds KVM view"| node_kvmhtml
node_mobile -.->|"controls remote KVM"| node_server
node_config -.->|"configures service"| node_server

click node_server "https://github.com/mdpwbe-sys/jarvis.package/blob/main/server.py"
click node_dispatcher "https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/dispatcher.py"
click node_conversation "https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/conversation.py"
click node_sessions "https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/session.py"
click node_memory "https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/memory.py"
click node_config "https://github.com/mdpwbe-sys/jarvis.package/blob/main/config.py"
click node_agents "https://github.com/mdpwbe-sys/jarvis.package/tree/main/modules"
click node_skills "https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/skills_manager.py"
click node_web "https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/scraper.py"
click node_notebook "https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/notebook_engine.py"
click node_extractor "https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/pdf_engine.py"
click node_gemini "https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/gemini_engine.py"
click node_dashboardfeed "https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/dashboard_feed.py"
click node_kvm "https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/kvm.py"
click node_security "https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/security_guard.py"
click node_documents "https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/doc_builder.py"
click node_oi "https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/oi.py"
click node_desktopmain "https://github.com/mdpwbe-sys/jarvis.package/blob/main/JarvisDesktop/src/main/main.js"
click node_bridge "https://github.com/mdpwbe-sys/jarvis.package/blob/main/JarvisDesktop/src/main/systemBridge.js"
click node_desktopui "https://github.com/mdpwbe-sys/jarvis.package/blob/main/JarvisDesktop/src/renderer/App.jsx"
click node_dashboard "https://github.com/mdpwbe-sys/jarvis.package/blob/main/JarvisDesktop/src/renderer/components/Dashboard.jsx"
click node_terminal "https://github.com/mdpwbe-sys/jarvis.package/blob/main/JarvisDesktop/src/renderer/components/TerminalView.jsx"
click node_chat "https://github.com/mdpwbe-sys/jarvis.package/blob/main/JarvisDesktop/src/renderer/components/ChatView.jsx"
click node_mobile "https://github.com/mdpwbe-sys/jarvis.package/blob/main/AppIOS/App.js"
click node_kvmhtml "https://github.com/mdpwbe-sys/jarvis.package/blob/main/AppIOS/components/HtmlTemplates.js"

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_server,node_dispatcher,node_conversation,node_sessions,node_memory,node_config,node_user toneBlue
class node_agents,node_skills,node_web,node_notebook,node_extractor,node_gemini toneAmber
class node_dashboardfeed,node_kvm,node_security,node_documents,node_oi toneMint
class node_desktopmain,node_bridge,node_desktopui,node_dashboard,node_terminal,node_chat toneRose
class node_mobile,node_kvmhtml,node_ollama toneIndigo
```

## Components

### Backend orchestration

- [API server](https://github.com/mdpwbe-sys/jarvis.package/blob/main/server.py): `server.py`
- [Request dispatcher](https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/dispatcher.py): `modules/dispatcher.py`
- [Conversation handling](https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/conversation.py): `modules/conversation.py`
- [Session archive](https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/session.py): `modules/session.py`
- [Persistent memory](https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/memory.py): `modules/memory.py`
- [Configuration](https://github.com/mdpwbe-sys/jarvis.package/blob/main/config.py): `config.py`

### Knowledge and agents

- [AI agents](https://github.com/mdpwbe-sys/jarvis.package/tree/main/modules): `modules`
- [Skills discovery](https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/skills_manager.py): `modules/skills_manager.py`
- [Web research](https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/scraper.py): `modules/scraper.py`
- [Document notebook](https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/notebook_engine.py): `modules/notebook_engine.py`
- [Document extraction](https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/pdf_engine.py): `modules/pdf_engine.py`
- [Gemini generation](https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/gemini_engine.py): `modules/gemini_engine.py`

### Machine capabilities

- [Dashboard telemetry](https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/dashboard_feed.py): `modules/dashboard_feed.py`
- [KVM control](https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/kvm.py): `modules/kvm.py`
- [Security controls](https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/security_guard.py): `modules/security_guard.py`
- [Document generation](https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/doc_builder.py): `modules/doc_builder.py`
- [Machine operations](https://github.com/mdpwbe-sys/jarvis.package/blob/main/modules/oi.py): `modules/oi.py`

### Desktop client

- [Desktop runtime](https://github.com/mdpwbe-sys/jarvis.package/blob/main/JarvisDesktop/src/main/main.js): `JarvisDesktop/src/main/main.js`
- [System telemetry bridge](https://github.com/mdpwbe-sys/jarvis.package/blob/main/JarvisDesktop/src/main/systemBridge.js): `JarvisDesktop/src/main/systemBridge.js`
- [Desktop interface](https://github.com/mdpwbe-sys/jarvis.package/blob/main/JarvisDesktop/src/renderer/App.jsx): `JarvisDesktop/src/renderer/App.jsx`
- [Dashboard view](https://github.com/mdpwbe-sys/jarvis.package/blob/main/JarvisDesktop/src/renderer/components/Dashboard.jsx): `JarvisDesktop/src/renderer/components/Dashboard.jsx`
- [Terminal view](https://github.com/mdpwbe-sys/jarvis.package/blob/main/JarvisDesktop/src/renderer/components/TerminalView.jsx): `JarvisDesktop/src/renderer/components/TerminalView.jsx`
- [Chat view](https://github.com/mdpwbe-sys/jarvis.package/blob/main/JarvisDesktop/src/renderer/components/ChatView.jsx): `JarvisDesktop/src/renderer/components/ChatView.jsx`

### Mobile client

- [iOS KVM client](https://github.com/mdpwbe-sys/jarvis.package/blob/main/AppIOS/App.js): `AppIOS/App.js`
- [KVM web templates](https://github.com/mdpwbe-sys/jarvis.package/blob/main/AppIOS/components/HtmlTemplates.js): `AppIOS/components/HtmlTemplates.js`

### Other components

- **User**
- **Local Ollama**

## Connections

- User → API server: submits requests (evidence: `README.md`)
- API server → Request dispatcher: dispatches requests (evidence: `server.py`)
- API server → Conversation handling: routes conversation (evidence: `server.py`)
- API server → Session archive: manages sessions (evidence: `server.py`)
- API server → Persistent memory: reads and saves (evidence: `server.py`)
- API server → KVM control: routes KVM control (evidence: `server.py`)
- API server → Dashboard telemetry: serves telemetry (evidence: `server.py`)
- API server → Security controls: uses security controls (evidence: `server.py`)
- Request dispatcher → Conversation handling: delegates requests (evidence: `modules/dispatcher.py`)
- Request dispatcher → Persistent memory: uses persistent memory (evidence: `modules/dispatcher.py`)
- Request dispatcher → Skills discovery: loads skills (evidence: `modules/dispatcher.py`)
- Request dispatcher → Web research: uses web research (evidence: `modules/dispatcher.py`)
- Request dispatcher → Machine operations: routes operations (evidence: `modules/dispatcher.py`)
- Request dispatcher → AI agents: routes agent tasks (evidence: `modules/dispatcher.py`)
- Conversation handling → Persistent memory: reads and updates (evidence: `modules/conversation.py`)
- Conversation handling → Session archive: uses session handling (evidence: `modules/conversation.py`)
- Session archive → Persistent memory: persists session state (evidence: `modules/session.py`)
- Session archive → Local Ollama: requests titles (evidence: `modules/session.py`)
- Document notebook → Document extraction: extracts source text (evidence: `modules/notebook_engine.py`)
- Document notebook → Gemini generation: sends grounded questions (evidence: `modules/notebook_engine.py`)
- Desktop runtime → System telemetry bridge: starts telemetry bridge (evidence: `JarvisDesktop/src/main/main.js`)
- Desktop runtime → API server: starts backend process (evidence: `JarvisDesktop/src/main/main.js`)
- Desktop interface → Dashboard view: renders dashboard (evidence: `JarvisDesktop/src/renderer/App.jsx`)
- Desktop interface → Terminal view: renders terminal (evidence: `JarvisDesktop/src/renderer/App.jsx`)
- Desktop interface → Chat view: renders chat (evidence: `JarvisDesktop/src/renderer/App.jsx`)
- iOS KVM client → KVM web templates: builds KVM view (evidence: `AppIOS/App.js`)
- iOS KVM client → API server: controls remote KVM (evidence: `README.md`)
- Configuration → API server: configures service (evidence: `README.md`)
