meeting-assistant/openspec/changes/archive/2026-05-28-warm-up-pyannote-on-startup/proposal.md

Change: Warm up pyannote on startup

Why

Local pyannote validation can spend significant time building the Docker image and downloading Hugging Face model artifacts. If that work happens on the first speaker-validation request, the request can time out before validation starts.

What Changes

• Increase the local pyannote validation command timeout default.
• Add a startup warm-up path that prepares enabled pyannote diarization runtimes and downloads the configured model into the persistent cache.
• Keep startup non-blocking and keep diarization requests bounded by configured timeouts.

Impact

• First speaker validation is less likely to fail due to one-time model setup.
• Startup logs can surface pyannote setup failures before the first meeting needs validation.