How hsynylmz-umhg/vesper works
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: engine.py Session engine · repository.py Session repository · ui.py Web interface · config.py Processing configuration
Components 18
User interaction
- Web interface
ui.py - CLI entry
main.py
Live processing
- Session engine
vesper/engine.py - Audio capture + VAD
vesper/audio_capture.py - Whisper transcription
vesper/transcriber.py - Live/final summaries
vesper/summarizer.py - Local Ollama
- Processing configuration
vesper/config.py
Session persistence
- Session repository
vesper/repository.py - SQLite database
vesper/storage.py - Session data models
vesper/session.py
Root-level modules
- Root audio capture
audio_capture.py - Root configuration
config.py - Root interface
ui.py - Root repository
repository.py - Root SQLite storage
storage.py - Root session models
session.py
Other components
- User
Connections 23
- User → Web interface: uses
README.md - User → CLI entry: starts
main.py - Web interface → Session engine: controls sessions
ui.py - CLI entry → Session engine: starts/stops
main.py - Session engine → Audio capture + VAD: starts capture
vesper/engine.py - Audio capture + VAD → Session engine: queues audio
README.md - Session engine → Whisper transcription: transcribes audio
vesper/engine.py - Session engine → Live/final summaries: requests summaries
vesper/engine.py - Live/final summaries → Local Ollama: generates summaries
README.md - Session engine → Session repository: persists session data
vesper/engine.py - Session repository → SQLite database: reads/writes records
vesper/repository.py - Session repository → Session data models: maps records
vesper/repository.py - Web interface → Session repository: browses history
- Session repository → Web interface: exports Markdown
- Root audio capture → Root configuration: uses settings
audio_capture.py - Root repository → Root SQLite storage: uses database
repository.py - Root repository → Root session models: uses models
repository.py - Root interface → Session engine: imports engine
ui.py - Root interface → Root session models: imports models
- Session engine → Processing configuration: uses settings
vesper/engine.py - Audio capture + VAD → Processing configuration: uses settings
vesper/audio_capture.py - Whisper transcription → Processing configuration: uses settings
vesper/transcriber.py - Live/final summaries → Processing configuration: uses profiles
vesper/summarizer.py