# hsynylmz-umhg/vesper architecture

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

## Overview

Vesper captures Windows system audio, detects speech, transcribes it locally, and periodically produces live and final summaries. The NiceGUI interface supports live sessions and browsing saved history; SQLite is the durable source of session data, with Markdown as an export. The graph reflects the documented workflow and indexed module references; unsampled implementation details and some legacy root-level modules are therefore shown only where their connections are evidenced.

Main entry points: [`vesper/engine.py`](https://github.com/hsynylmz-umhg/vesper/blob/main/vesper/engine.py) (Session engine), [`vesper/repository.py`](https://github.com/hsynylmz-umhg/vesper/blob/main/vesper/repository.py) (Session repository), [`ui.py`](https://github.com/hsynylmz-umhg/vesper/blob/main/ui.py) (Web interface), [`vesper/config.py`](https://github.com/hsynylmz-umhg/vesper/blob/main/vesper/config.py) (Processing configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["User interaction"]
  node_ui["Web interface<br/>[ui.py]"]
  node_cli["CLI entry<br/>[main.py]"]
end

subgraph group_workflow["Live processing"]
  node_engine["Session engine<br/>[engine.py]"]
  node_audio["Audio capture + VAD<br/>[audio_capture.py]"]
  node_transcriber["Whisper transcription<br/>[transcriber.py]"]
  node_summarizer["Live/final summaries<br/>[summarizer.py]"]
  node_ollama["Local Ollama"]
  node_config["Processing configuration<br/>[config.py]"]
end

subgraph group_persistence["Session persistence"]
  node_repo["Session repository<br/>[repository.py]"]
  node_db[("SQLite database<br/>[storage.py]")]
  node_models["Session data models<br/>[session.py]"]
end

subgraph group_legacy["Root-level modules"]
  node_legacy_audio["Root audio capture<br/>[audio_capture.py]"]
  node_legacy_config["Root configuration<br/>[config.py]"]
  node_legacy_ui["Root interface<br/>[ui.py]"]
  node_legacy_repo["Root repository<br/>[repository.py]"]
  node_legacy_db[("Root SQLite storage<br/>[storage.py]")]
  node_legacy_models["Root session models<br/>[session.py]"]
end

node_user(("User"))

node_user -->|"uses"| node_ui
node_user -->|"starts"| node_cli
node_ui -->|"controls sessions"| node_engine
node_cli -->|"starts/stops"| node_engine
node_engine -->|"starts capture"| node_audio
node_audio -->|"queues audio"| node_engine
node_engine -->|"transcribes audio"| node_transcriber
node_engine -->|"requests summaries"| node_summarizer
node_summarizer -->|"generates summaries"| node_ollama
node_engine -->|"persists session data"| node_repo
node_repo -->|"reads/writes records"| node_db
node_repo -->|"maps records"| node_models
node_ui -.->|"browses history"| node_repo
node_repo -.->|"exports Markdown"| node_ui
node_legacy_audio -->|"uses settings"| node_legacy_config
node_legacy_repo -->|"uses database"| node_legacy_db
node_legacy_repo -->|"uses models"| node_legacy_models
node_legacy_ui -->|"imports engine"| node_engine
node_legacy_ui -.->|"imports models"| node_legacy_models
node_engine -->|"uses settings"| node_config
node_audio -->|"uses settings"| node_config
node_transcriber -->|"uses settings"| node_config
node_summarizer -->|"uses profiles"| node_config

click node_ui "https://github.com/hsynylmz-umhg/vesper/blob/main/ui.py"
click node_cli "https://github.com/hsynylmz-umhg/vesper/blob/main/main.py"
click node_engine "https://github.com/hsynylmz-umhg/vesper/blob/main/vesper/engine.py"
click node_audio "https://github.com/hsynylmz-umhg/vesper/blob/main/vesper/audio_capture.py"
click node_transcriber "https://github.com/hsynylmz-umhg/vesper/blob/main/vesper/transcriber.py"
click node_summarizer "https://github.com/hsynylmz-umhg/vesper/blob/main/vesper/summarizer.py"
click node_repo "https://github.com/hsynylmz-umhg/vesper/blob/main/vesper/repository.py"
click node_db "https://github.com/hsynylmz-umhg/vesper/blob/main/vesper/storage.py"
click node_models "https://github.com/hsynylmz-umhg/vesper/blob/main/vesper/session.py"
click node_legacy_audio "https://github.com/hsynylmz-umhg/vesper/blob/main/audio_capture.py"
click node_legacy_config "https://github.com/hsynylmz-umhg/vesper/blob/main/config.py"
click node_legacy_ui "https://github.com/hsynylmz-umhg/vesper/blob/main/ui.py"
click node_legacy_repo "https://github.com/hsynylmz-umhg/vesper/blob/main/repository.py"
click node_legacy_db "https://github.com/hsynylmz-umhg/vesper/blob/main/storage.py"
click node_legacy_models "https://github.com/hsynylmz-umhg/vesper/blob/main/session.py"
click node_config "https://github.com/hsynylmz-umhg/vesper/blob/main/vesper/config.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_ui,node_cli,node_user toneBlue
class node_engine,node_audio,node_transcriber,node_summarizer,node_ollama,node_config toneAmber
class node_repo,node_db,node_models toneMint
class node_legacy_audio,node_legacy_config,node_legacy_ui,node_legacy_repo,node_legacy_db,node_legacy_models toneRose
```

## Components

### User interaction

- [Web interface](https://github.com/hsynylmz-umhg/vesper/blob/main/ui.py): `ui.py`
- [CLI entry](https://github.com/hsynylmz-umhg/vesper/blob/main/main.py): `main.py`

### Live processing

- [Session engine](https://github.com/hsynylmz-umhg/vesper/blob/main/vesper/engine.py): `vesper/engine.py`
- [Audio capture + VAD](https://github.com/hsynylmz-umhg/vesper/blob/main/vesper/audio_capture.py): `vesper/audio_capture.py`
- [Whisper transcription](https://github.com/hsynylmz-umhg/vesper/blob/main/vesper/transcriber.py): `vesper/transcriber.py`
- [Live/final summaries](https://github.com/hsynylmz-umhg/vesper/blob/main/vesper/summarizer.py): `vesper/summarizer.py`
- **Local Ollama**
- [Processing configuration](https://github.com/hsynylmz-umhg/vesper/blob/main/vesper/config.py): `vesper/config.py`

### Session persistence

- [Session repository](https://github.com/hsynylmz-umhg/vesper/blob/main/vesper/repository.py): `vesper/repository.py`
- [SQLite database](https://github.com/hsynylmz-umhg/vesper/blob/main/vesper/storage.py): `vesper/storage.py`
- [Session data models](https://github.com/hsynylmz-umhg/vesper/blob/main/vesper/session.py): `vesper/session.py`

### Root-level modules

- [Root audio capture](https://github.com/hsynylmz-umhg/vesper/blob/main/audio_capture.py): `audio_capture.py`
- [Root configuration](https://github.com/hsynylmz-umhg/vesper/blob/main/config.py): `config.py`
- [Root interface](https://github.com/hsynylmz-umhg/vesper/blob/main/ui.py): `ui.py`
- [Root repository](https://github.com/hsynylmz-umhg/vesper/blob/main/repository.py): `repository.py`
- [Root SQLite storage](https://github.com/hsynylmz-umhg/vesper/blob/main/storage.py): `storage.py`
- [Root session models](https://github.com/hsynylmz-umhg/vesper/blob/main/session.py): `session.py`

### Other components

- **User**

## Connections

- User → Web interface: uses (evidence: `README.md`)
- User → CLI entry: starts (evidence: `main.py`)
- Web interface → Session engine: controls sessions (evidence: `ui.py`)
- CLI entry → Session engine: starts/stops (evidence: `main.py`)
- Session engine → Audio capture + VAD: starts capture (evidence: `vesper/engine.py`)
- Audio capture + VAD → Session engine: queues audio (evidence: `README.md`)
- Session engine → Whisper transcription: transcribes audio (evidence: `vesper/engine.py`)
- Session engine → Live/final summaries: requests summaries (evidence: `vesper/engine.py`)
- Live/final summaries → Local Ollama: generates summaries (evidence: `README.md`)
- Session engine → Session repository: persists session data (evidence: `vesper/engine.py`)
- Session repository → SQLite database: reads/writes records (evidence: `vesper/repository.py`)
- Session repository → Session data models: maps records (evidence: `vesper/repository.py`)
- Web interface → Session repository: browses history
- Session repository → Web interface: exports Markdown
- Root audio capture → Root configuration: uses settings (evidence: `audio_capture.py`)
- Root repository → Root SQLite storage: uses database (evidence: `repository.py`)
- Root repository → Root session models: uses models (evidence: `repository.py`)
- Root interface → Session engine: imports engine (evidence: `ui.py`)
- Root interface → Root session models: imports models
- Session engine → Processing configuration: uses settings (evidence: `vesper/engine.py`)
- Audio capture + VAD → Processing configuration: uses settings (evidence: `vesper/audio_capture.py`)
- Whisper transcription → Processing configuration: uses settings (evidence: `vesper/transcriber.py`)
- Live/final summaries → Processing configuration: uses profiles (evidence: `vesper/summarizer.py`)
