# virat692/jarvis-completed-ai-os architecture

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

- Interactive diagram: https://gitdiagram.com/virat692/jarvis-completed-ai-os
- Repository: https://github.com/virat692/jarvis-completed-ai-os

## Overview

This repository is a JARVIS-branded AI desktop/web assistant with a React interface, AI-provider integrations, browser automation, weather and system controls, memory, and a presentation workspace. The main user-facing path enters through App.tsx, which coordinates the assistant UI and its feature panels; other distinct capabilities include autonomous browser tasks and structured workspace rendering. The excerpts establish several service-level calls, but many UI and service implementations were not sampled, so their internal connections are omitted rather than inferred.

Main entry points: [`App.tsx`](https://github.com/virat692/jarvis-completed-ai-os/blob/main/App.tsx) (Assistant App), [`services/browserAgent/browserAgent.ts`](https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/browserAgent/browserAgent.ts) (Browser Agent), [`components/WeatherPanel.tsx`](https://github.com/virat692/jarvis-completed-ai-os/blob/main/components/WeatherPanel.tsx) (Weather Panel), [`services/eventBus.ts`](https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/eventBus.ts) (Event Bus)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Assistant Interface"]
  node_app["Assistant App<br/>[App.tsx]"]
  node_chat["Chat Interface<br/>[ChatBox.tsx]"]
  node_history["Chat History"]
  node_memoryui["Memory Panel<br/>[MemoryPanel.tsx]"]
  node_controlui["OS Controls"]
  node_weatherui["Weather Panel<br/>[WeatherPanel.tsx]"]
  node_browserui["Browser HUD"]
end

subgraph group_intelligence["AI and Memory"]
  node_providers["Provider Manager"]
  node_openrouter["OpenRouter Provider"]
  node_openrouterapi["OpenRouter Service"]
  node_neuralrouter["Neural Router<br/>[neuralRouter.ts]"]
  node_memory["Memory System<br/>[memorySystem.ts]"]
end

subgraph group_automation["Automation"]
  node_browseragent["Browser Agent<br/>[browserAgent.ts]"]
  node_actionplanner["Action Planner<br/>[actionPlanner.ts]"]
  node_controller["Browser Controller"]
  node_recovery["Recovery Engine<br/>[recoveryEngine.ts]"]
end

subgraph group_workspace["Workspace"]
  node_workspaceui["Neural Workspace"]
  node_workspacerouter["Presentation Router"]
  node_paragraph["Document View"]
  node_workspacehistory["Workspace History"]
end

subgraph group_integrations["System Integrations"]
  node_eventbus["Event Bus<br/>[eventBus.ts]"]
  node_runtime["Runtime Engine<br/>[runtimeEngine.ts]"]
  node_osbridge["OS Bridge<br/>[osBridge.ts]"]
  node_weather["Weather Service"]
  node_weathercontrol["Weather Controls"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_chat
node_app -->|"renders"| node_history
node_app -->|"renders"| node_memoryui
node_app -->|"renders"| node_controlui
node_app -->|"renders"| node_weatherui
node_app -->|"renders"| node_browserui
node_app -->|"opens"| node_workspaceui
node_openrouter -->|"sends requests"| node_openrouterapi
node_neuralrouter -->|"emits events"| node_eventbus
node_memory -->|"emits events"| node_eventbus
node_runtime -->|"emits events"| node_eventbus
node_browserui -->|"starts tasks"| node_browseragent
node_browseragent -->|"plans actions"| node_actionplanner
node_browseragent -->|"executes actions"| node_controller
node_browseragent -->|"requests recovery"| node_recovery
node_controller -->|"executes remotely"| node_osbridge
node_workspaceui -->|"routes presentation"| node_workspacerouter
node_workspacerouter -->|"renders paragraph"| node_paragraph
node_weatherui -->|"uses weather data"| node_weather
node_weatherui -->|"uses controls"| node_weathercontrol

click node_app "https://github.com/virat692/jarvis-completed-ai-os/blob/main/App.tsx"
click node_chat "https://github.com/virat692/jarvis-completed-ai-os/blob/main/components/ChatBox.tsx"
click node_history "https://github.com/virat692/jarvis-completed-ai-os/blob/main/components/ChatHistoryPanel.tsx"
click node_memoryui "https://github.com/virat692/jarvis-completed-ai-os/blob/main/components/MemoryPanel.tsx"
click node_controlui "https://github.com/virat692/jarvis-completed-ai-os/blob/main/components/OSControlConsole.tsx"
click node_weatherui "https://github.com/virat692/jarvis-completed-ai-os/blob/main/components/WeatherPanel.tsx"
click node_browserui "https://github.com/virat692/jarvis-completed-ai-os/blob/main/components/BrowserAgentHUD.tsx"
click node_providers "https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/AIProviderManager.ts"
click node_openrouter "https://github.com/virat692/jarvis-completed-ai-os/blob/main/providers/OpenRouterProvider.ts"
click node_openrouterapi "https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/openRouterService.ts"
click node_neuralrouter "https://github.com/virat692/jarvis-completed-ai-os/blob/main/ai/neuralRouter.ts"
click node_memory "https://github.com/virat692/jarvis-completed-ai-os/blob/main/memory/memorySystem.ts"
click node_browseragent "https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/browserAgent/browserAgent.ts"
click node_actionplanner "https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/browserAgent/actionPlanner.ts"
click node_controller "https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/browserAgent/browserController.ts"
click node_recovery "https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/browserAgent/recoveryEngine.ts"
click node_workspaceui "https://github.com/virat692/jarvis-completed-ai-os/blob/main/components/NeuralWorkspace/NeuralWorkspace.tsx"
click node_workspacerouter "https://github.com/virat692/jarvis-completed-ai-os/blob/main/components/NeuralWorkspace/WorkspaceRouter.tsx"
click node_paragraph "https://github.com/virat692/jarvis-completed-ai-os/blob/main/components/NeuralWorkspace/ParagraphPresentation.tsx"
click node_workspacehistory "https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/workspaceHistoryService.ts"
click node_eventbus "https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/eventBus.ts"
click node_runtime "https://github.com/virat692/jarvis-completed-ai-os/blob/main/runtime/runtimeEngine.ts"
click node_osbridge "https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/osBridge.ts"
click node_weather "https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/openWeatherService.ts"
click node_weathercontrol "https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/weatherControlService.ts"

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_app,node_chat,node_history,node_memoryui,node_controlui,node_weatherui,node_browserui,node_user toneBlue
class node_providers,node_openrouter,node_openrouterapi,node_neuralrouter,node_memory toneAmber
class node_browseragent,node_actionplanner,node_controller,node_recovery toneMint
class node_workspaceui,node_workspacerouter,node_paragraph,node_workspacehistory toneRose
class node_eventbus,node_runtime,node_osbridge,node_weather,node_weathercontrol toneIndigo
```

## Components

### Assistant Interface

- [Assistant App](https://github.com/virat692/jarvis-completed-ai-os/blob/main/App.tsx): `App.tsx`
- [Chat Interface](https://github.com/virat692/jarvis-completed-ai-os/blob/main/components/ChatBox.tsx): `components/ChatBox.tsx`
- [Chat History](https://github.com/virat692/jarvis-completed-ai-os/blob/main/components/ChatHistoryPanel.tsx): `components/ChatHistoryPanel.tsx`
- [Memory Panel](https://github.com/virat692/jarvis-completed-ai-os/blob/main/components/MemoryPanel.tsx): `components/MemoryPanel.tsx`
- [OS Controls](https://github.com/virat692/jarvis-completed-ai-os/blob/main/components/OSControlConsole.tsx): `components/OSControlConsole.tsx`
- [Weather Panel](https://github.com/virat692/jarvis-completed-ai-os/blob/main/components/WeatherPanel.tsx): `components/WeatherPanel.tsx`
- [Browser HUD](https://github.com/virat692/jarvis-completed-ai-os/blob/main/components/BrowserAgentHUD.tsx): `components/BrowserAgentHUD.tsx`

### AI and Memory

- [Provider Manager](https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/AIProviderManager.ts): `services/AIProviderManager.ts`
- [OpenRouter Provider](https://github.com/virat692/jarvis-completed-ai-os/blob/main/providers/OpenRouterProvider.ts): `providers/OpenRouterProvider.ts`
- [OpenRouter Service](https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/openRouterService.ts): `services/openRouterService.ts`
- [Neural Router](https://github.com/virat692/jarvis-completed-ai-os/blob/main/ai/neuralRouter.ts): `ai/neuralRouter.ts`
- [Memory System](https://github.com/virat692/jarvis-completed-ai-os/blob/main/memory/memorySystem.ts): `memory/memorySystem.ts`

### Automation

- [Browser Agent](https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/browserAgent/browserAgent.ts): `services/browserAgent/browserAgent.ts`
- [Action Planner](https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/browserAgent/actionPlanner.ts): `services/browserAgent/actionPlanner.ts`
- [Browser Controller](https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/browserAgent/browserController.ts): `services/browserAgent/browserController.ts`
- [Recovery Engine](https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/browserAgent/recoveryEngine.ts): `services/browserAgent/recoveryEngine.ts`

### Workspace

- [Neural Workspace](https://github.com/virat692/jarvis-completed-ai-os/blob/main/components/NeuralWorkspace/NeuralWorkspace.tsx): `components/NeuralWorkspace/NeuralWorkspace.tsx`
- [Presentation Router](https://github.com/virat692/jarvis-completed-ai-os/blob/main/components/NeuralWorkspace/WorkspaceRouter.tsx): `components/NeuralWorkspace/WorkspaceRouter.tsx`
- [Document View](https://github.com/virat692/jarvis-completed-ai-os/blob/main/components/NeuralWorkspace/ParagraphPresentation.tsx): `components/NeuralWorkspace/ParagraphPresentation.tsx`
- [Workspace History](https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/workspaceHistoryService.ts): `services/workspaceHistoryService.ts`

### System Integrations

- [Event Bus](https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/eventBus.ts): `services/eventBus.ts`
- [Runtime Engine](https://github.com/virat692/jarvis-completed-ai-os/blob/main/runtime/runtimeEngine.ts): `runtime/runtimeEngine.ts`
- [OS Bridge](https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/osBridge.ts): `services/osBridge.ts`
- [Weather Service](https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/openWeatherService.ts): `services/openWeatherService.ts`
- [Weather Controls](https://github.com/virat692/jarvis-completed-ai-os/blob/main/services/weatherControlService.ts): `services/weatherControlService.ts`

### Other components

- **User**

## Connections

- User → Assistant App: uses (evidence: `App.tsx`)
- Assistant App → Chat Interface: renders (evidence: `App.tsx`)
- Assistant App → Chat History: renders (evidence: `App.tsx`)
- Assistant App → Memory Panel: renders (evidence: `App.tsx`)
- Assistant App → OS Controls: renders (evidence: `App.tsx`)
- Assistant App → Weather Panel: renders (evidence: `App.tsx`)
- Assistant App → Browser HUD: renders (evidence: `App.tsx`)
- Assistant App → Neural Workspace: opens (evidence: `App.tsx`)
- OpenRouter Provider → OpenRouter Service: sends requests (evidence: `providers/OpenRouterProvider.ts`)
- Neural Router → Event Bus: emits events (evidence: `ai/neuralRouter.ts`)
- Memory System → Event Bus: emits events (evidence: `memory/memorySystem.ts`)
- Runtime Engine → Event Bus: emits events (evidence: `runtime/runtimeEngine.ts`)
- Browser HUD → Browser Agent: starts tasks (evidence: `components/BrowserAgentHUD.tsx`)
- Browser Agent → Action Planner: plans actions (evidence: `services/browserAgent/browserAgent.ts`)
- Browser Agent → Browser Controller: executes actions (evidence: `services/browserAgent/browserAgent.ts`)
- Browser Agent → Recovery Engine: requests recovery (evidence: `services/browserAgent/browserAgent.ts`)
- Browser Controller → OS Bridge: executes remotely (evidence: `services/browserAgent/browserController.ts`)
- Neural Workspace → Presentation Router: routes presentation (evidence: `components/NeuralWorkspace/WorkspaceRouter.tsx`)
- Presentation Router → Document View: renders paragraph (evidence: `components/NeuralWorkspace/WorkspaceRouter.tsx`)
- Weather Panel → Weather Service: uses weather data (evidence: `components/WeatherPanel.tsx`)
- Weather Panel → Weather Controls: uses controls (evidence: `components/WeatherPanel.tsx`)
