# emrekulce/voice-assistant-gui-sesli-asistan-arayuz architecture

> Architecture diagram of the GitHub repository emrekulce/voice-assistant-gui-sesli-asistan-arayuz, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz
- Repository: https://github.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz

## Overview

This repository is a lightweight floating HUD library for Python voice assistants, not a speech-recognition or AI-processing stack. The integration workflow is to start an overlay, report assistant lifecycle and audio/transcript updates through the bridge/controller, and display them in a separate Tkinter process. The README documents additional visual and interaction features. The worker’s full command-dispatch implementation was not excerpted, so that connection is marked unverified.

Main entry points: [`assistant_overlay_gui.py`](https://github.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz/blob/main/assistant_overlay_gui.py) (Overlay controller), [`example_custom_assistant.py`](https://github.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz/blob/main/example_custom_assistant.py) (Custom assistant example)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_integrator(("Assistant integration"))
node_example["Custom assistant example"]
node_bridge["Assistant bridge"]
node_api["Overlay controller"]
node_config["Config and states"]
node_queue["Command queue"]
node_worker["GUI process worker"]
node_hud["Tkinter HUD"]
node_visuals["HUD visuals"]
node_rms["RMS utility"]

node_integrator -->|"customizes"| node_example
node_example -->|"subclasses"| node_bridge
node_example -->|"starts overlay"| node_api
node_bridge -->|"reports events"| node_api
node_api -->|"queues commands"| node_queue
node_api -->|"starts process"| node_worker
node_worker -.->|"reads commands"| node_queue
node_worker -.->|"runs GUI"| node_hud
node_hud -->|"renders states"| node_visuals
node_rms -.->|"feeds amplitude"| node_visuals

click node_example "https://github.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz/blob/main/example_custom_assistant.py"
click node_bridge "https://github.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz/blob/main/assistant_overlay_gui.py"
click node_api "https://github.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz/blob/main/assistant_overlay_gui.py"
click node_config "https://github.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz/blob/main/assistant_overlay_gui.py"
click node_queue "https://github.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz/blob/main/assistant_overlay_gui.py"
click node_worker "https://github.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz/blob/main/assistant_overlay_gui.py"
click node_hud "https://github.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz/blob/main/assistant_overlay_gui.py"
click node_visuals "https://github.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz/blob/main/assistant_overlay_gui.py"
click node_rms "https://github.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz/blob/main/assistant_overlay_gui.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_integrator toneIndigo
class node_example,node_bridge,node_api,node_config,node_hud,node_visuals,node_rms toneTeal
class node_queue,node_worker toneRose
```

## Components

### Other components

- **Assistant integration**
- [Custom assistant example](https://github.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz/blob/main/example_custom_assistant.py): `example_custom_assistant.py`
- [Assistant bridge](https://github.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz/blob/main/assistant_overlay_gui.py): `assistant_overlay_gui.py`
- [Overlay controller](https://github.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz/blob/main/assistant_overlay_gui.py): `assistant_overlay_gui.py`
- [Config and states](https://github.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz/blob/main/assistant_overlay_gui.py): `assistant_overlay_gui.py`
- [Command queue](https://github.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz/blob/main/assistant_overlay_gui.py): `assistant_overlay_gui.py`
- [GUI process worker](https://github.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz/blob/main/assistant_overlay_gui.py): `assistant_overlay_gui.py`
- [Tkinter HUD](https://github.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz/blob/main/assistant_overlay_gui.py): `assistant_overlay_gui.py`
- [HUD visuals](https://github.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz/blob/main/assistant_overlay_gui.py): `assistant_overlay_gui.py`
- [RMS utility](https://github.com/emrekulce/voice-assistant-gui-sesli-asistan-arayuz/blob/main/assistant_overlay_gui.py): `assistant_overlay_gui.py`

## Connections

- Assistant integration → Custom assistant example: customizes (evidence: `README.md`)
- Custom assistant example → Assistant bridge: subclasses (evidence: `example_custom_assistant.py`)
- Custom assistant example → Overlay controller: starts overlay (evidence: `example_custom_assistant.py`)
- Assistant bridge → Overlay controller: reports events (evidence: `assistant_overlay_gui.py`)
- Overlay controller → Command queue: queues commands (evidence: `assistant_overlay_gui.py`)
- Overlay controller → GUI process worker: starts process (evidence: `assistant_overlay_gui.py`)
- GUI process worker → Command queue: reads commands (evidence: `assistant_overlay_gui.py`)
- GUI process worker → Tkinter HUD: runs GUI (evidence: `assistant_overlay_gui.py`)
- Tkinter HUD → HUD visuals: renders states (evidence: `assistant_overlay_gui.py`)
- RMS utility → HUD visuals: feeds amplitude (evidence: `assistant_overlay_gui.py`)