# frigadehq/yogurt architecture

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

- Interactive diagram: https://gitdiagram.com/frigadehq/yogurt
- Repository: https://github.com/frigadehq/yogurt

## Overview

Yogurt is a private, local-first desktop meeting-notes app. The user starts or accepts a recording offer; the app captures microphone and system audio, transcribes speech live, stores the meeting, and generates notes with a local model. Users can search meetings and ask questions with source links; optional MCP access exposes meeting data to local assistant apps. The README establishes the main product flow and local-processing claims. Source excerpts show selected implementation links, but many renderer, calendar, and library internals were not sampled.

Main entry points: [`app/src/renderer/src/App.tsx`](https://github.com/frigadehq/yogurt/blob/main/app/src/renderer/src/App.tsx) (Desktop UI), [`app/src/main/capture.ts`](https://github.com/frigadehq/yogurt/blob/main/app/src/main/capture.ts) (Audio capture), [`app/src/main/store.ts`](https://github.com/frigadehq/yogurt/blob/main/app/src/main/store.ts) (Meeting store), [`app/src/main/asr/pipeline.ts`](https://github.com/frigadehq/yogurt/blob/main/app/src/main/asr/pipeline.ts) (Transcription pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_meeting["Meeting capture"]
  node_capture["Audio capture<br/>[capture.ts]"]
  node_audio_mac["macOS recorder<br/>[main.swift]"]
  node_audio_win["Windows recorder<br/>[main.rs]"]
  node_audio_linux["Linux recorder<br/>[main.rs]"]
  node_detection["Call detection<br/>[detect.ts]"]
  node_system_helper["System helper<br/>[main.rs]"]
end

subgraph group_intelligence["Local intelligence"]
  node_transcription["Transcription pipeline<br/>[pipeline.ts]"]
  node_asr_service["Speech services<br/>[server.ts]"]
  node_notes["Notes generation<br/>[index.ts]"]
  node_engine_host["Model host<br/>[engine.ts]"]
  node_engine_worker["Model worker<br/>[worker.ts]"]
end

subgraph group_workspace["Meeting workspace"]
  node_desktop["Desktop UI<br/>[App.tsx]"]
  node_meeting_store[("Meeting store<br/>[store.ts]")]
  node_library["Search and retrieval<br/>[retrieve.ts]"]
  node_calendar["Calendar context<br/>[calendar.ts]"]
end

subgraph group_integrations["Access and integrations"]
  node_mcp["Local MCP server<br/>[server.ts]"]
end

node_user(("User"))
node_assistant_app(("Assistant app"))
node_model_downloads["Model downloads"]
node_updates["Update service"]

node_user -->|"starts recording"| node_desktop
node_desktop -.->|"controls capture"| node_capture
node_capture -.->|"records audio"| node_audio_mac
node_capture -.->|"records audio"| node_audio_win
node_capture -.->|"records audio"| node_audio_linux
node_detection -->|"queries call state"| node_system_helper
node_desktop -->|"offers recording"| node_detection
node_capture -->|"audio for transcription"| node_transcription
node_transcription -.->|"uses speech services"| node_asr_service
node_transcription -.->|"saves transcript"| node_meeting_store
node_transcription -->|"streams live text"| node_desktop
node_meeting_store -.->|"provides meeting data"| node_notes
node_notes -.->|"requests generation"| node_engine_host
node_engine_host -->|"dispatches model work"| node_engine_worker
node_notes -.->|"stores notes"| node_meeting_store
node_user -->|"searches and asks"| node_desktop
node_desktop -.->|"requests search or answers"| node_library
node_library -.->|"retrieves meetings"| node_meeting_store
node_library -.->|"requests answer"| node_engine_host
node_desktop -.->|"shows calendar context"| node_calendar
node_assistant_app -->|"requests meeting data"| node_mcp
node_mcp -->|"reads meetings"| node_meeting_store
node_mcp -->|"reads calendar details"| node_calendar
node_model_downloads -->|"provides models"| node_user
node_updates -->|"provides update checks"| node_user

click node_desktop "https://github.com/frigadehq/yogurt/blob/main/app/src/renderer/src/App.tsx"
click node_capture "https://github.com/frigadehq/yogurt/blob/main/app/src/main/capture.ts"
click node_audio_mac "https://github.com/frigadehq/yogurt/blob/main/app/native/yogurt-audio/main.swift"
click node_audio_win "https://github.com/frigadehq/yogurt/blob/main/app/native/yogurt-audio-win/src/main.rs"
click node_audio_linux "https://github.com/frigadehq/yogurt/blob/main/app/native/yogurt-audio-linux/src/main.rs"
click node_detection "https://github.com/frigadehq/yogurt/blob/main/app/src/main/detect.ts"
click node_system_helper "https://github.com/frigadehq/yogurt/blob/main/app/native/yogurt-system/src/main.rs"
click node_transcription "https://github.com/frigadehq/yogurt/blob/main/app/src/main/asr/pipeline.ts"
click node_asr_service "https://github.com/frigadehq/yogurt/blob/main/app/src/main/asr/server.ts"
click node_meeting_store "https://github.com/frigadehq/yogurt/blob/main/app/src/main/store.ts"
click node_notes "https://github.com/frigadehq/yogurt/blob/main/app/src/main/notes/index.ts"
click node_engine_host "https://github.com/frigadehq/yogurt/blob/main/app/src/main/engine.ts"
click node_engine_worker "https://github.com/frigadehq/yogurt/blob/main/app/src/engine/worker.ts"
click node_library "https://github.com/frigadehq/yogurt/blob/main/app/src/main/library/retrieve.ts"
click node_calendar "https://github.com/frigadehq/yogurt/blob/main/app/src/main/calendar.ts"
click node_mcp "https://github.com/frigadehq/yogurt/blob/main/app/src/main/mcp/server.ts"

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_capture,node_audio_mac,node_audio_win,node_audio_linux,node_detection,node_system_helper,node_user toneBlue
class node_transcription,node_asr_service,node_notes,node_engine_host,node_engine_worker toneAmber
class node_desktop,node_meeting_store,node_library,node_calendar toneMint
class node_mcp toneRose
class node_assistant_app,node_model_downloads,node_updates toneIndigo
```

## Components

### Meeting capture

- [Audio capture](https://github.com/frigadehq/yogurt/blob/main/app/src/main/capture.ts): `app/src/main/capture.ts`
- [macOS recorder](https://github.com/frigadehq/yogurt/blob/main/app/native/yogurt-audio/main.swift): `app/native/yogurt-audio/main.swift`
- [Windows recorder](https://github.com/frigadehq/yogurt/blob/main/app/native/yogurt-audio-win/src/main.rs): `app/native/yogurt-audio-win/src/main.rs`
- [Linux recorder](https://github.com/frigadehq/yogurt/blob/main/app/native/yogurt-audio-linux/src/main.rs): `app/native/yogurt-audio-linux/src/main.rs`
- [Call detection](https://github.com/frigadehq/yogurt/blob/main/app/src/main/detect.ts): `app/src/main/detect.ts`
- [System helper](https://github.com/frigadehq/yogurt/blob/main/app/native/yogurt-system/src/main.rs): `app/native/yogurt-system/src/main.rs`

### Local intelligence

- [Transcription pipeline](https://github.com/frigadehq/yogurt/blob/main/app/src/main/asr/pipeline.ts): `app/src/main/asr/pipeline.ts`
- [Speech services](https://github.com/frigadehq/yogurt/blob/main/app/src/main/asr/server.ts): `app/src/main/asr/server.ts`
- [Notes generation](https://github.com/frigadehq/yogurt/blob/main/app/src/main/notes/index.ts): `app/src/main/notes/index.ts`
- [Model host](https://github.com/frigadehq/yogurt/blob/main/app/src/main/engine.ts): `app/src/main/engine.ts`
- [Model worker](https://github.com/frigadehq/yogurt/blob/main/app/src/engine/worker.ts): `app/src/engine/worker.ts`

### Meeting workspace

- [Desktop UI](https://github.com/frigadehq/yogurt/blob/main/app/src/renderer/src/App.tsx): `app/src/renderer/src/App.tsx`
- [Meeting store](https://github.com/frigadehq/yogurt/blob/main/app/src/main/store.ts): `app/src/main/store.ts`
- [Search and retrieval](https://github.com/frigadehq/yogurt/blob/main/app/src/main/library/retrieve.ts): `app/src/main/library/retrieve.ts`
- [Calendar context](https://github.com/frigadehq/yogurt/blob/main/app/src/main/calendar.ts): `app/src/main/calendar.ts`

### Access and integrations

- [Local MCP server](https://github.com/frigadehq/yogurt/blob/main/app/src/main/mcp/server.ts): `app/src/main/mcp/server.ts`

### Other components

- **User**
- **Assistant app**
- **Model downloads**
- **Update service**

## Connections

- User → Desktop UI: starts recording (evidence: `README.md`)
- Desktop UI → Audio capture: controls capture
- Audio capture → macOS recorder: records audio
- Audio capture → Windows recorder: records audio
- Audio capture → Linux recorder: records audio
- Call detection → System helper: queries call state (evidence: `app/native/yogurt-system/src/main.rs`)
- Desktop UI → Call detection: offers recording (evidence: `README.md`)
- Audio capture → Transcription pipeline: audio for transcription (evidence: `README.md`)
- Transcription pipeline → Speech services: uses speech services
- Transcription pipeline → Meeting store: saves transcript (evidence: `app/src/main/asr/pipeline.ts`)
- Transcription pipeline → Desktop UI: streams live text (evidence: `README.md`)
- Meeting store → Notes generation: provides meeting data
- Notes generation → Model host: requests generation
- Model host → Model worker: dispatches model work
- Notes generation → Meeting store: stores notes
- User → Desktop UI: searches and asks (evidence: `README.md`)
- Desktop UI → Search and retrieval: requests search or answers
- Search and retrieval → Meeting store: retrieves meetings
- Search and retrieval → Model host: requests answer
- Desktop UI → Calendar context: shows calendar context
- Assistant app → Local MCP server: requests meeting data (evidence: `README.md`)
- Local MCP server → Meeting store: reads meetings (evidence: `app/src/main/mcp/server.ts`)
- Local MCP server → Calendar context: reads calendar details (evidence: `app/src/main/mcp/server.ts`)
- Model downloads → User: provides models (evidence: `README.md`)
- Update service → User: provides update checks (evidence: `README.md`)
