# saathvik879/ghostdesk architecture

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

## Overview

GhostDesk AI is a desktop voice assistant. A user’s wake word starts command capture; the app transcribes and parses the command, then routes it to desktop actions or memory and responds with speech and optional overlay feedback. The README also describes typing, personality, and GUI capabilities. The only source excerpt is main.py, so links to documented but unsampled modules are based on README-described responsibilities, not verified implementation calls; bonus features are omitted because their implementation paths are not established.

Main entry points: [`main.py`](https://github.com/saathvik879/ghostdesk/blob/main/main.py) (Assistant orchestrator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Assistant Runtime"]
  node_app["Assistant orchestrator<br/>[main.py]"]
end

subgraph group_interaction["Voice Interaction"]
  node_wake["Wake listener"]
  node_stt["Speech recognition"]
  node_parser["Intent parser"]
end

subgraph group_actions["Command Actions"]
  node_typing["Human-like typing"]
  node_files["File and app control"]
end

subgraph group_feedback["Context and Feedback"]
  node_memory[("Assistant memory")]
  node_personality["Personality engine"]
  node_tts["Speech output"]
  node_overlay["GUI overlay"]
end

node_user(("Desktop user"))
node_desktop["Desktop environment"]
node_browser["Default browser"]

node_user -.->|"speaks wake word"| node_wake
node_app -->|"polls"| node_wake
node_app -->|"captures command"| node_stt
node_app -->|"parses transcript"| node_parser
node_app -->|"dispatches typing"| node_typing
node_app -->|"dispatches actions"| node_files
node_app -->|"queries memory"| node_memory
node_app -->|"generates responses"| node_personality
node_app -->|"speaks responses"| node_tts
node_app -->|"updates display"| node_overlay
node_files -.->|"opens and controls"| node_desktop
node_files -.->|"searches web"| node_browser
node_user -.->|"issues commands"| node_app

click node_app "https://github.com/saathvik879/ghostdesk/blob/main/main.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_app,node_user,node_browser toneBlue
class node_wake,node_stt,node_parser toneAmber
class node_typing,node_files toneMint
class node_memory,node_personality,node_tts,node_overlay toneRose
class node_desktop toneIndigo
```

## Components

### Assistant Runtime

- [Assistant orchestrator](https://github.com/saathvik879/ghostdesk/blob/main/main.py): `main.py`

### Voice Interaction

- **Wake listener**
- **Speech recognition**
- **Intent parser**

### Command Actions

- **Human-like typing**
- **File and app control**

### Context and Feedback

- **Assistant memory**
- **Personality engine**
- **Speech output**
- **GUI overlay**

### Other components

- **Desktop user**
- **Desktop environment**
- **Default browser**

## Connections

- Desktop user → Wake listener: speaks wake word (evidence: `README.md`)
- Assistant orchestrator → Wake listener: polls (evidence: `main.py`)
- Assistant orchestrator → Speech recognition: captures command (evidence: `main.py`)
- Assistant orchestrator → Intent parser: parses transcript (evidence: `main.py`)
- Assistant orchestrator → Human-like typing: dispatches typing (evidence: `main.py`)
- Assistant orchestrator → File and app control: dispatches actions (evidence: `main.py`)
- Assistant orchestrator → Assistant memory: queries memory (evidence: `main.py`)
- Assistant orchestrator → Personality engine: generates responses (evidence: `main.py`)
- Assistant orchestrator → Speech output: speaks responses (evidence: `main.py`)
- Assistant orchestrator → GUI overlay: updates display (evidence: `main.py`)
- File and app control → Desktop environment: opens and controls (evidence: `README.md`)
- File and app control → Default browser: searches web (evidence: `README.md`)
- Desktop user → Assistant orchestrator: issues commands (evidence: `README.md`)
