# kaixxx/noscribe architecture

> Architecture diagram of the GitHub repository kaixxx/noscribe, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kaixxx/noscribe
- Repository: https://github.com/kaixxx/noscribe

## Overview

noScribe is a local desktop application for producing and reviewing interview transcripts. Users select audio and transcription options in the GUI; the app manages jobs and dispatches speech recognition and speaker diarization to worker processes, then presents transcript segments for review and export. The README also documents multilingual support and local processing for confidentiality. Worker internals and much of the GUI are only partially excerpted, so the graph shows documented or indexed relationships and omits uncertain calls.

Main entry points: [`noScribe/main.py`](https://github.com/kaixxx/noscribe/blob/main/noScribe/main.py) (Job and transcript GUI), [`noScribe/whisper_mp_worker.py`](https://github.com/kaixxx/noscribe/blob/main/noScribe/whisper_mp_worker.py) (Whisper worker), [`noScribe/pyannote_mp_worker.py`](https://github.com/kaixxx/noscribe/blob/main/noScribe/pyannote_mp_worker.py) (Diarization worker), [`noScribe/CTkToolTips.py`](https://github.com/kaixxx/noscribe/blob/main/noScribe/CTkToolTips.py) (GUI tooltips)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop app"]
  node_gui["Job and transcript GUI<br/>[main.py]"]
  node_queue["Transcription job queue<br/>[main.py]"]
  node_tooltips["GUI tooltips<br/>[CTkToolTips.py]"]
  node_hyperlinks["Log hyperlinks"]
end

subgraph group_audio["Audio preparation"]
  node_audio_conversion["Audio conversion<br/>[convert.py]"]
end

subgraph group_speech["Speech processing"]
  node_model_catalog["Whisper model catalog<br/>[transcription.py]"]
  node_whisper_worker["Whisper worker"]
  node_diarization_worker["Diarization worker"]
  node_model_files["Bundled models"]
end

subgraph group_transcript["Transcript support"]
  node_transcript_utils["Transcript utilities<br/>[utils.py]"]
  node_localization["Localization resources"]
end

node_user(("Interview researcher"))
node_audio_input["Interview audio"]
node_transcript_output["Reviewed transcript"]

node_user -->|"configures jobs"| node_gui
node_audio_input -->|"selects audio"| node_gui
node_gui -->|"manages jobs"| node_queue
node_gui -.->|"prepares audio"| node_audio_conversion
node_gui -->|"lists models"| node_model_catalog
node_gui -->|"dispatches recognition"| node_whisper_worker
node_gui -->|"dispatches diarization"| node_diarization_worker
node_gui -->|"uses utilities"| node_transcript_utils
node_gui -->|"uses tooltips"| node_tooltips
node_gui -->|"uses hyperlinks"| node_hyperlinks
node_whisper_worker -->|"loads messages"| node_localization
node_whisper_worker -->|"streams segments"| node_transcript_output
node_diarization_worker -->|"reads audio"| node_audio_input
node_diarization_worker -->|"returns segments"| node_gui
node_gui -->|"presents for review"| node_transcript_output
node_user -->|"reviews transcript"| node_transcript_output

click node_gui "https://github.com/kaixxx/noscribe/blob/main/noScribe/main.py"
click node_queue "https://github.com/kaixxx/noscribe/blob/main/noScribe/main.py"
click node_audio_conversion "https://github.com/kaixxx/noscribe/blob/main/noScribe/audio/convert.py"
click node_model_catalog "https://github.com/kaixxx/noscribe/blob/main/noScribe/transcription.py"
click node_whisper_worker "https://github.com/kaixxx/noscribe/blob/main/noScribe/whisper_mp_worker.py"
click node_diarization_worker "https://github.com/kaixxx/noscribe/blob/main/noScribe/pyannote_mp_worker.py"
click node_model_files "https://github.com/kaixxx/noscribe/tree/main/models"
click node_transcript_utils "https://github.com/kaixxx/noscribe/blob/main/noScribe/utils.py"
click node_tooltips "https://github.com/kaixxx/noscribe/blob/main/noScribe/CTkToolTips.py"
click node_hyperlinks "https://github.com/kaixxx/noscribe/blob/main/noScribe/tkHyperlinkManager.py"
click node_localization "https://github.com/kaixxx/noscribe/tree/main/trans"

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_gui,node_queue,node_tooltips,node_hyperlinks,node_user,node_audio_input,node_transcript_output toneBlue
class node_audio_conversion toneAmber
class node_model_catalog,node_whisper_worker,node_diarization_worker,node_model_files toneMint
class node_transcript_utils,node_localization toneRose
```

## Components

### Desktop app

- [Job and transcript GUI](https://github.com/kaixxx/noscribe/blob/main/noScribe/main.py): `noScribe/main.py`
- [Transcription job queue](https://github.com/kaixxx/noscribe/blob/main/noScribe/main.py): `noScribe/main.py`
- [GUI tooltips](https://github.com/kaixxx/noscribe/blob/main/noScribe/CTkToolTips.py): `noScribe/CTkToolTips.py`
- [Log hyperlinks](https://github.com/kaixxx/noscribe/blob/main/noScribe/tkHyperlinkManager.py): `noScribe/tkHyperlinkManager.py`

### Audio preparation

- [Audio conversion](https://github.com/kaixxx/noscribe/blob/main/noScribe/audio/convert.py): `noScribe/audio/convert.py`

### Speech processing

- [Whisper model catalog](https://github.com/kaixxx/noscribe/blob/main/noScribe/transcription.py): `noScribe/transcription.py`
- [Whisper worker](https://github.com/kaixxx/noscribe/blob/main/noScribe/whisper_mp_worker.py): `noScribe/whisper_mp_worker.py`
- [Diarization worker](https://github.com/kaixxx/noscribe/blob/main/noScribe/pyannote_mp_worker.py): `noScribe/pyannote_mp_worker.py`
- [Bundled models](https://github.com/kaixxx/noscribe/tree/main/models): `models`

### Transcript support

- [Transcript utilities](https://github.com/kaixxx/noscribe/blob/main/noScribe/utils.py): `noScribe/utils.py`
- [Localization resources](https://github.com/kaixxx/noscribe/tree/main/trans): `trans`

### Other components

- **Interview researcher**
- **Interview audio**
- **Reviewed transcript**

## Connections

- Interview researcher → Job and transcript GUI: configures jobs (evidence: `README.md`)
- Interview audio → Job and transcript GUI: selects audio (evidence: `README.md`)
- Job and transcript GUI → Transcription job queue: manages jobs (evidence: `noScribe/main.py`)
- Job and transcript GUI → Audio conversion: prepares audio
- Job and transcript GUI → Whisper model catalog: lists models (evidence: `noScribe/main.py`)
- Job and transcript GUI → Whisper worker: dispatches recognition (evidence: `noScribe/main.py`)
- Job and transcript GUI → Diarization worker: dispatches diarization (evidence: `noScribe/main.py`)
- Job and transcript GUI → Transcript utilities: uses utilities (evidence: `noScribe/main.py`)
- Job and transcript GUI → GUI tooltips: uses tooltips (evidence: `noScribe/main.py`)
- Job and transcript GUI → Log hyperlinks: uses hyperlinks (evidence: `noScribe/main.py`)
- Whisper worker → Localization resources: loads messages (evidence: `noScribe/whisper_mp_worker.py`)
- Whisper worker → Reviewed transcript: streams segments (evidence: `noScribe/whisper_mp_worker.py`)
- Diarization worker → Interview audio: reads audio (evidence: `noScribe/pyannote_mp_worker.py`)
- Diarization worker → Job and transcript GUI: returns segments (evidence: `noScribe/main.py`)
- Job and transcript GUI → Reviewed transcript: presents for review (evidence: `README.md`)
- Interview researcher → Reviewed transcript: reviews transcript (evidence: `README.md`)
