# goncalvestalie/poc-ia-transcription architecture

> Architecture diagram of the GitHub repository goncalvestalie/poc-ia-transcription, 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/goncalvestalie/poc-ia-transcription
- Repository: https://github.com/goncalvestalie/poc-ia-transcription

## Overview

This Windows desktop proof of concept captures microphone audio, streams it to Voxtral for live transcription, and lets the user generate a structured Mistral summary with an editable prompt and copyable output. The runtime is concentrated in `poc.py`; the graph separates its UI, transcription, and summarization responsibilities. The README documents the overall audio-to-cloud workflow; excerpts show UI transcript handling and the summary API call, but omitted code limits verification of some internal wiring.

Main entry points: [`poc.py`](https://github.com/goncalvestalie/poc-ia-transcription/blob/main/poc.py) (Summary request)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_app["Desktop app<br/>[poc.py]"]
  node_transcript_view["Transcript view<br/>[poc.py]"]
  node_prompt_editor["Prompt editor<br/>[poc.py]"]
  node_summary_view["Summary output<br/>[poc.py]"]
  node_clipboard["System clipboard"]
end

subgraph group_transcription["Live transcription"]
  node_microphone(("Microphone"))
  node_audio_capture["PCM capture<br/>[poc.py]"]
  node_voxtral["Voxtral realtime STT"]
  node_transcript["Live transcript<br/>[poc.py]"]
end

subgraph group_summary["Summary generation"]
  node_summary_flow["Summary request<br/>[poc.py]"]
  node_mistral["Mistral cloud API"]
  node_summary_result["Structured summary<br/>[poc.py]"]
end

node_user(("Desktop user"))

node_user -->|"operates"| node_app
node_microphone -->|"provides audio"| node_audio_capture
node_audio_capture -->|"streams chunks"| node_voxtral
node_voxtral -->|"transcribes"| node_transcript
node_transcript -->|"displays deltas"| node_transcript_view
node_user -->|"edits prompt"| node_prompt_editor
node_user -->|"requests summary"| node_summary_flow
node_transcript -->|"injects text"| node_summary_flow
node_prompt_editor -->|"supplies prompt"| node_summary_flow
node_summary_flow -->|"requests completion"| node_mistral
node_mistral -->|"returns summary"| node_summary_result
node_summary_result -->|"shows result"| node_summary_view
node_user -->|"copies summary"| node_summary_view

click node_app "https://github.com/goncalvestalie/poc-ia-transcription/blob/main/poc.py"
click node_transcript_view "https://github.com/goncalvestalie/poc-ia-transcription/blob/main/poc.py"
click node_prompt_editor "https://github.com/goncalvestalie/poc-ia-transcription/blob/main/poc.py"
click node_summary_view "https://github.com/goncalvestalie/poc-ia-transcription/blob/main/poc.py"
click node_audio_capture "https://github.com/goncalvestalie/poc-ia-transcription/blob/main/poc.py"
click node_transcript "https://github.com/goncalvestalie/poc-ia-transcription/blob/main/poc.py"
click node_summary_flow "https://github.com/goncalvestalie/poc-ia-transcription/blob/main/poc.py"
click node_summary_result "https://github.com/goncalvestalie/poc-ia-transcription/blob/main/poc.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_transcript_view,node_prompt_editor,node_summary_view,node_clipboard,node_user toneBlue
class node_microphone,node_audio_capture,node_voxtral,node_transcript toneAmber
class node_summary_flow,node_mistral,node_summary_result toneMint
```

## Components

### Desktop interface

- [Desktop app](https://github.com/goncalvestalie/poc-ia-transcription/blob/main/poc.py): `poc.py`
- [Transcript view](https://github.com/goncalvestalie/poc-ia-transcription/blob/main/poc.py): `poc.py`
- [Prompt editor](https://github.com/goncalvestalie/poc-ia-transcription/blob/main/poc.py): `poc.py`
- [Summary output](https://github.com/goncalvestalie/poc-ia-transcription/blob/main/poc.py): `poc.py`
- **System clipboard**

### Live transcription

- **Microphone**
- [PCM capture](https://github.com/goncalvestalie/poc-ia-transcription/blob/main/poc.py): `poc.py`
- **Voxtral realtime STT**
- [Live transcript](https://github.com/goncalvestalie/poc-ia-transcription/blob/main/poc.py): `poc.py`

### Summary generation

- [Summary request](https://github.com/goncalvestalie/poc-ia-transcription/blob/main/poc.py): `poc.py`
- **Mistral cloud API**
- [Structured summary](https://github.com/goncalvestalie/poc-ia-transcription/blob/main/poc.py): `poc.py`

### Other components

- **Desktop user**

## Connections

- Desktop user → Desktop app: operates (evidence: `README.md`)
- Microphone → PCM capture: provides audio (evidence: `README.md`)
- PCM capture → Voxtral realtime STT: streams chunks (evidence: `README.md`)
- Voxtral realtime STT → Live transcript: transcribes (evidence: `README.md`)
- Live transcript → Transcript view: displays deltas (evidence: `poc.py`)
- Desktop user → Prompt editor: edits prompt (evidence: `README.md`)
- Desktop user → Summary request: requests summary (evidence: `README.md`)
- Live transcript → Summary request: injects text (evidence: `README.md`)
- Prompt editor → Summary request: supplies prompt (evidence: `poc.py`)
- Summary request → Mistral cloud API: requests completion (evidence: `poc.py`)
- Mistral cloud API → Structured summary: returns summary (evidence: `README.md`)
- Structured summary → Summary output: shows result (evidence: `README.md`)
- Desktop user → Summary output: copies summary (evidence: `README.md`)
