# rudra00434/opencluely-v2.0 architecture

> Architecture diagram of the GitHub repository rudra00434/opencluely-v2.0, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rudra00434/opencluely-v2.0
- Repository: https://github.com/rudra00434/opencluely-v2.0

## Overview

OpenCluely is an Electron interview copilot: users ask by voice or screenshot, Gemini reasons with skill prompts and session context, and answers stream to overlay or chat. The graph follows the documented workflow and sampled imports/calls; several renderer and integration details are unsampled, so unsupported connections are omitted.

Main entry points: [`main.js`](https://github.com/rudra00434/opencluely-v2.0/blob/main/main.js) (App Controller), [`src/services/llm.service.js`](https://github.com/rudra00434/opencluely-v2.0/blob/main/src/services/llm.service.js) (Gemini Reasoning), [`src/services/speech.service.js`](https://github.com/rudra00434/opencluely-v2.0/blob/main/src/services/speech.service.js) (Speech Capture), [`src/services/capture.service.js`](https://github.com/rudra00434/opencluely-v2.0/blob/main/src/services/capture.service.js) (Screenshot Capture)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop Control"]
  node_controller["App Controller<br/>[main.js]"]
  node_settings["Configuration<br/>[config.js]"]
  node_first_run["First Run<br/>[first-run.js]"]
  node_whisper_setup["Whisper Setup"]
end

subgraph group_input["Capture and Speech"]
  node_screenshot["Screenshot Capture<br/>[capture.service.js]"]
  node_speech["Speech Capture<br/>[speech.service.js]"]
  node_worker["Whisper Worker"]
end

subgraph group_reason["AI and Session"]
  node_session["Session Memory<br/>[session.manager.js]"]
  node_prompts["Skill Prompts<br/>[prompt-loader.js]"]
  node_llm["Gemini Reasoning<br/>[llm.service.js]"]
end

subgraph group_presentation["Windows and Support"]
  node_windows["Window Manager<br/>[window.manager.js]"]
  node_main_ui["Main Window UI<br/>[main-window.js]"]
  node_chat_ui["Chat Window UI<br/>[chat-window.js]"]
  node_settings_ui["Settings Window UI<br/>[settings-window.js]"]
  node_response_view["Answer Renderer<br/>[llm-response.html]"]
  node_markdown["Markdown Rendering<br/>[markdown.js]"]
  node_math["Math Rendering<br/>[mathrender.js]"]
  node_logger["Logging<br/>[logger.js]"]
end

node_user(("Interview User"))
node_azure{{"Azure Speech"}}
node_gemini{{"Gemini API"}}

node_user -->|"asks questions"| node_controller
node_controller -->|"requests capture"| node_screenshot
node_controller -->|"controls capture"| node_speech
node_controller -->|"submits questions"| node_llm
node_screenshot -->|"sends image"| node_llm
node_speech -->|"transcribes locally"| node_worker
node_speech -.->|"uses provider"| node_azure
node_llm -->|"requests answers"| node_gemini
node_llm -->|"uses context"| node_session
node_llm -->|"loads prompts"| node_prompts
node_session -->|"loads skill prompts"| node_prompts
node_controller -->|"manages session"| node_session
node_controller -->|"selects skills"| node_prompts
node_controller -->|"initializes windows"| node_windows
node_controller -->|"checks onboarding"| node_first_run
node_controller -->|"sets up Whisper"| node_whisper_setup
node_windows -->|"loads response window"| node_response_view
node_response_view -.->|"renders markdown"| node_markdown
node_response_view -.->|"renders math"| node_math
node_controller -.->|"serves interface"| node_main_ui
node_controller -->|"routes voice answers"| node_chat_ui
node_controller -.->|"configures preferences"| node_settings_ui
node_speech -->|"logs events"| node_logger
node_screenshot -->|"logs capture"| node_logger
node_controller -->|"reads settings"| node_settings

click node_controller "https://github.com/rudra00434/opencluely-v2.0/blob/main/main.js"
click node_settings "https://github.com/rudra00434/opencluely-v2.0/blob/main/src/core/config.js"
click node_first_run "https://github.com/rudra00434/opencluely-v2.0/blob/main/src/core/first-run.js"
click node_whisper_setup "https://github.com/rudra00434/opencluely-v2.0/blob/main/src/core/whisper-installer.js"
click node_screenshot "https://github.com/rudra00434/opencluely-v2.0/blob/main/src/services/capture.service.js"
click node_speech "https://github.com/rudra00434/opencluely-v2.0/blob/main/src/services/speech.service.js"
click node_worker "https://github.com/rudra00434/opencluely-v2.0/blob/main/src/services/whisper-worker.service.js"
click node_session "https://github.com/rudra00434/opencluely-v2.0/blob/main/src/managers/session.manager.js"
click node_prompts "https://github.com/rudra00434/opencluely-v2.0/blob/main/prompt-loader.js"
click node_llm "https://github.com/rudra00434/opencluely-v2.0/blob/main/src/services/llm.service.js"
click node_windows "https://github.com/rudra00434/opencluely-v2.0/blob/main/src/managers/window.manager.js"
click node_main_ui "https://github.com/rudra00434/opencluely-v2.0/blob/main/src/ui/main-window.js"
click node_chat_ui "https://github.com/rudra00434/opencluely-v2.0/blob/main/src/ui/chat-window.js"
click node_settings_ui "https://github.com/rudra00434/opencluely-v2.0/blob/main/src/ui/settings-window.js"
click node_response_view "https://github.com/rudra00434/opencluely-v2.0/blob/main/llm-response.html"
click node_markdown "https://github.com/rudra00434/opencluely-v2.0/blob/main/lib/markdown.js"
click node_math "https://github.com/rudra00434/opencluely-v2.0/blob/main/lib/mathrender.js"
click node_logger "https://github.com/rudra00434/opencluely-v2.0/blob/main/src/core/logger.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_controller,node_settings,node_first_run,node_whisper_setup,node_user toneBlue
class node_screenshot,node_speech,node_worker toneAmber
class node_session,node_prompts,node_llm,node_gemini toneMint
class node_windows,node_main_ui,node_chat_ui,node_settings_ui,node_response_view,node_markdown,node_math,node_logger toneRose
class node_azure toneIndigo
```

## Components

### Desktop Control

- [App Controller](https://github.com/rudra00434/opencluely-v2.0/blob/main/main.js): `main.js`
- [Configuration](https://github.com/rudra00434/opencluely-v2.0/blob/main/src/core/config.js): `src/core/config.js`
- [First Run](https://github.com/rudra00434/opencluely-v2.0/blob/main/src/core/first-run.js): `src/core/first-run.js`
- [Whisper Setup](https://github.com/rudra00434/opencluely-v2.0/blob/main/src/core/whisper-installer.js): `src/core/whisper-installer.js`

### Capture and Speech

- [Screenshot Capture](https://github.com/rudra00434/opencluely-v2.0/blob/main/src/services/capture.service.js): `src/services/capture.service.js`
- [Speech Capture](https://github.com/rudra00434/opencluely-v2.0/blob/main/src/services/speech.service.js): `src/services/speech.service.js`
- [Whisper Worker](https://github.com/rudra00434/opencluely-v2.0/blob/main/src/services/whisper-worker.service.js): `src/services/whisper-worker.service.js`

### AI and Session

- [Session Memory](https://github.com/rudra00434/opencluely-v2.0/blob/main/src/managers/session.manager.js): `src/managers/session.manager.js`
- [Skill Prompts](https://github.com/rudra00434/opencluely-v2.0/blob/main/prompt-loader.js): `prompt-loader.js`
- [Gemini Reasoning](https://github.com/rudra00434/opencluely-v2.0/blob/main/src/services/llm.service.js): `src/services/llm.service.js`

### Windows and Support

- [Window Manager](https://github.com/rudra00434/opencluely-v2.0/blob/main/src/managers/window.manager.js): `src/managers/window.manager.js`
- [Main Window UI](https://github.com/rudra00434/opencluely-v2.0/blob/main/src/ui/main-window.js): `src/ui/main-window.js`
- [Chat Window UI](https://github.com/rudra00434/opencluely-v2.0/blob/main/src/ui/chat-window.js): `src/ui/chat-window.js`
- [Settings Window UI](https://github.com/rudra00434/opencluely-v2.0/blob/main/src/ui/settings-window.js): `src/ui/settings-window.js`
- [Answer Renderer](https://github.com/rudra00434/opencluely-v2.0/blob/main/llm-response.html): `llm-response.html`
- [Markdown Rendering](https://github.com/rudra00434/opencluely-v2.0/blob/main/lib/markdown.js): `lib/markdown.js`
- [Math Rendering](https://github.com/rudra00434/opencluely-v2.0/blob/main/lib/mathrender.js): `lib/mathrender.js`
- [Logging](https://github.com/rudra00434/opencluely-v2.0/blob/main/src/core/logger.js): `src/core/logger.js`

### Other components

- **Interview User**
- **Azure Speech**
- **Gemini API**

## Connections

- Interview User → App Controller: asks questions (evidence: `README.md`)
- App Controller → Screenshot Capture: requests capture (evidence: `main.js`)
- App Controller → Speech Capture: controls capture (evidence: `main.js`)
- App Controller → Gemini Reasoning: submits questions (evidence: `README.md`)
- Screenshot Capture → Gemini Reasoning: sends image (evidence: `README.md`)
- Speech Capture → Whisper Worker: transcribes locally (evidence: `src/services/speech.service.js`)
- Speech Capture → Azure Speech: uses provider (evidence: `README.md`)
- Gemini Reasoning → Gemini API: requests answers (evidence: `README.md`)
- Gemini Reasoning → Session Memory: uses context (evidence: `src/services/llm.service.js`)
- Gemini Reasoning → Skill Prompts: loads prompts (evidence: `src/services/llm.service.js`)
- Session Memory → Skill Prompts: loads skill prompts (evidence: `src/managers/session.manager.js`)
- App Controller → Session Memory: manages session (evidence: `main.js`)
- App Controller → Skill Prompts: selects skills (evidence: `main.js`)
- App Controller → Window Manager: initializes windows (evidence: `main.js`)
- App Controller → First Run: checks onboarding (evidence: `main.js`)
- App Controller → Whisper Setup: sets up Whisper (evidence: `main.js`)
- Window Manager → Answer Renderer: loads response window (evidence: `src/managers/window.manager.js`)
- Answer Renderer → Markdown Rendering: renders markdown
- Answer Renderer → Math Rendering: renders math
- App Controller → Main Window UI: serves interface
- App Controller → Chat Window UI: routes voice answers (evidence: `README.md`)
- App Controller → Settings Window UI: configures preferences
- Speech Capture → Logging: logs events (evidence: `src/services/speech.service.js`)
- Screenshot Capture → Logging: logs capture (evidence: `src/services/capture.service.js`)
- App Controller → Configuration: reads settings (evidence: `main.js`)
