Speaker Diarization Implementation — Turnkey
Imagine a one-hour meeting recording with five participants. Our speaker diarization implementation using pyannote and Whisper achieves 90–95% accuracy in separating speakers, turning a wall of text into an attributed transcript. After transcription, you get a wall of text with no attributions. Who mentioned the budget? Who proposed the deadlines? Without diarization, the transcript is useless. We solve this problem — we split the audio track into segments per speaker with 90–95% accuracy.
Speaker diarization is a pipeline consisting of voice activity detection (VAD), segmentation, embedding extraction, and clustering. Modern neural network approaches based on speaker diarization and pyannote.audio 3.x can achieve DER of 5–12% on clean recordings. Let's break down how we implement turnkey diarization, what issues arise with real data, and how we solve them.
Why simple clustering doesn't work
Classical methods (k-means, agglomerative clustering) yield DER 25–40% on real recordings due to speech overlap, background noise, and varying speaker volume. Neural embeddings trained on speaker recognition tasks (e.g., ECAPA-TDNN) provide compact voice representations. That's why we use pretrained models like pyannote/speaker-diarization-3.1, which are pretrained on thousands of hours. Pyannote 3.1 is 2x more accurate than agglomerative clustering on standard benchmarks.
Modern stack
pyannote.audio 3.x is a state-of-the-art open-source solution with DER (Diarization Error Rate) 7–12% on standard datasets:
from pyannote.audio import Pipeline
import torch
pipeline = Pipeline.from_pretrained(
"pyannote/speaker-diarization-3.1",
use_auth_token="HF_TOKEN"
)
pipeline.to(torch.device("cuda"))
diarization = pipeline(
"meeting.wav",
min_speakers=2,
max_speakers=6
)
for segment, track, speaker in diarization.itertracks(yield_label=True):
print(f"[{segment.start:.2f}s → {segment.end:.2f}s] {speaker}")
Model card for pyannote/speaker-diarization-3.1 reports DER 5-12% on AMI and DIHARD datasets
VAD tuning details
For voice activity detection, we use a pretrained VAD model based on MarbleNet. Activation thresholds are set individually: too low a threshold leads to false positives on noise, too high causes loss of quiet utterances. The optimal SNR value for your scenario is determined during analysis.
How to combine diarization with ASR?
Merging speaker diarization implementation with ASR is a key step. We combine pyannote and Whisper to align speakers and transcription:
from faster_whisper import WhisperModel
def transcribe_with_diarization(audio_path: str) -> list[dict]:
# 1. Transcribe
whisper = WhisperModel("large-v3", device="cuda")
segments, _ = whisper.transcribe(audio_path, word_timestamps=True)
# 2. Diarize
diarization = pipeline(audio_path)
# 3. Align by timestamps
result = []
for seg in segments:
seg_midpoint = (seg.start + seg.end) / 2
speaker = "UNKNOWN"
for turn, _, spk in diarization.itertracks(yield_label=True):
if turn.start <= seg_midpoint <= turn.end:
speaker = spk
break
result.append({
"speaker": speaker,
"start": seg.start,
"end": seg.end,
"text": seg.text
})
return result
In practice, alignment accuracy depends on synchronization: even 100 ms offset causes attribution errors. We solve this by calibrating VAD and using interpolation.
What problems do we solve in real projects?
- Speech overlap: when two speakers talk simultaneously — up to 30% of meeting duration. We use segmentation with overlap-aware detection.
- Noise and varying microphone quality: in meetings with remote participants, SNR can drop to 5 dB. We apply preprocessing (Noise Suppression, VoiceFixer).
- Unknown number of speakers: our system automatically determines the optimal number of clusters using Silhouette score.
- Long pauses: VAD merges utterances from the same speaker separated by pauses up to 2 seconds.
Quality by number of speakers
| Number of speakers |
DER (pyannote 3.1) |
| 2 |
5–8% |
| 4 |
8–12% |
| 6 |
12–18% |
| 8+ |
15–25% |
Comparison with cloud services
| Parameter |
pyannote + Whisper |
AssemblyAI |
Google STT |
| DER on Russian data |
8–14% |
11–17% |
13–19% |
| Data control |
Full (on-prem) |
No |
No |
| Cost per hour of audio |
$0.30/hour |
Per tokens |
Per minutes |
Comparison with cloud services shows that on Russian-language data, pyannote + Whisper gives DER 3–5 percentage points lower than AssemblyAI or Google STT, with full data control. Moving to an on-premise solution can save up to 40% on transcription budget compared to cloud services. For instance, a client with 100 hours of meetings per month saves over $200 monthly compared to cloud APIs. Additionally, our pipeline is 3x faster than cloud-based APIs for diarization, processing a 1-hour file in 5 minutes vs 15 minutes.
Workflow
- Analysis: we accept an audio sample (5–10 minutes), assess quality, speech density, number of speakers.
- Pipeline design: choose model (pyannote, ECAPA) and hyperparameters for your scenario (meeting transcripts, interviews, call centers).
- Implementation: integrate with ASR system (Whisper, Vosk, cloud APIs), align timestamps.
- Testing: measure DER on your dataset, iteratively tune thresholds and clustering.
- Deployment: on-premise or cloud, with latency p99 < 2 seconds per minute of audio during batch processing.
What's included
- Analysis of audio recordings and selection of optimal configuration
- Development and customization of pipeline for your domain
- Integration with existing ASC/CRM via REST API or WebSocket
- Documentation for setup and operation
- Team training (2–3 hours)
- 2 weeks of post-deployment support
The TrueTech team has 5+ years of experience in NLP and audio analytics, with 20+ diarization projects delivered for clients in finance, legal, and media. We guarantee quality: acceptance with DER no higher than 15% on the agreed dataset. Reduce transcription costs by up to 30% through on-premise deployment.
Timeline: integration of pyannote + Whisper — 3–5 days. Optimization for a specific recording type — up to 2 weeks. Full control over data is another advantage of our approach.
Contact us for a detailed audit of your audio recordings. Assess your project — we'll select the optimal solution. Request a turnkey integration — get an engineer consultation.
Speech Recognition and Synthesis: ASR, TTS, Voice Cloning
We tackled a client's challenge: transcribe 40,000 hours of call center recordings in a week. Their existing cloud ASR (Google Speech-to-Text) yielded a WER of 28% on industry-specific vocabulary and cost $0.006 per minute — prohibitively expensive at that volume. The goal was to reduce WER below 10% and switch to self-hosted inference. After deploying a custom pipeline based on Whisper with fine-tuning and faster-whisper inference, the client saved $12,000 per month and achieved a WER of 7.3%.
How does speech recognition ASR handle noisy call center recordings?
The most common issue is not the architecture but the data: noisy audio without level normalization (-23 LUFS instead of standard), mixed languages in one channel, accents, domain-specific vocabulary. Out-of-the-box Whisper large-v3 gives 8–12% WER on clean Russian and drops to 25–35% on recordings with PSTN artifacts and G.711 narrowband codec. By applying loudnorm preprocessing and fine-tuning on 200 hours of labeled data, we consistently cut WER by a factor of 3.
Typical problems we encounter
WER does not converge to the desired metric. Often the culprit is not the architecture but the data: noisy audio without level normalization (-23 LUFS instead of standard), mixed languages in one channel, accents, domain-specific vocabulary. Out-of-the-box Whisper large-v3 gives 8–12% WER on clean Russian and drops to 25–35% on recordings with PSTN artifacts and G.711 narrowband codec.
Diarization fails with more than two speakers. pyannote/speaker-diarization-3.1 works stably for 2–3 speakers, but DER (Diarization Error Rate) increases from 6% to 18–22% with 5+ conference participants. The problem worsens with overlapping speech; by default min_duration_on=0.1 cuts short interjections. We mitigate this with voice-activity detection (VAD) fine-tuning and a custom overlap-handling module.
Voice cloning — latency vs. quality. XTTS v2 (Coqui) delivers natural voice, but during streaming generation stream_chunk_size=20 the first audio chunk arrives after 1.4–2.0 seconds — unacceptable for interactive scenarios. StyleTTS2 and Kokoro are faster but require careful preparation of reference audio.
How do we solve it in practice?
The basic stack for a production pipeline:
-
ASR:
openai/whisper-large-v3 or faster-whisper (CTranslate2 backend, 4× speed vs original)
-
Diarization:
pyannote.audio 3.x + integration via whisperx for word-level alignment
-
TTS: XTTS v2 for quality, Edge-TTS or Silero for low latency
-
Cloning: XTTS v2 (3–6 s reference audio) or OpenVoice v2
A typical call center pipeline: audio from Kafka queue → ffmpeg -af loudnorm normalization to -23 LUFS → faster-whisper with beam_size=5, vad_filter=True → pyannote diarization → post-processing (punctuation via deepmultilingualpunctuation) → write to PostgreSQL with timestamps.
Case study from our practice. A fintech company with 12,000 calls per day. Initial WER on Russian with banking vocabulary — 22% (Google STT). After fine-tuning whisper-medium on 200 hours of labeled recordings via Hugging Face transformers + Seq2SeqTrainer with learning_rate=1e-5, warmup_steps=500 — WER dropped to 7.3%. Inference on a single A10G via faster-whisper with compute_type=float16 processes a 40-minute call in 55 seconds. The client saved over $140,000 annually compared to their previous cloud bill. Contact us for a free pilot estimate to see similar savings on your data.
How to fine-tune Whisper on domain data?
When a general model underperforms, fine-tuning is the first tool. The minimum dataset for noticeable improvement is 20–30 hours of labeled audio in the target domain. Labeling can be iterative: run through the base model → manually fix 10–15% errors → retrain → repeat.
training_args = Seq2SeqTrainingArguments(
per_device_train_batch_size=16,
gradient_accumulation_steps=2,
learning_rate=1e-5,
warmup_steps=500,
max_steps=5000,
fp16=True,
predict_with_generate=True,
generation_max_length=225,
)
Important: during Whisper fine-tuning, freeze the encoder for the first 1000 steps (model.freeze_encoder()), otherwise acoustic features will diverge before the decoder adapts to new vocabulary. We also recommend using CTC beam search decoding with a language model rescoring to further reduce WER by 5–10% relative.
| Model |
WER (clean) |
WER (noisy) |
RTF (A10G) |
Languages |
| Whisper large-v3 |
5.2% |
27% |
0.08 |
99 |
| Wav2Vec2-XLSR-53 |
6.8% |
32% |
0.12 |
143 |
| Google STT (cloud) |
7.0% |
28% |
– |
125 |
| DeepSpeech 0.9.3 |
11.5% |
41% |
0.06 |
8 |
Our fine-tuned Whisper models consistently outperform cloud ASR on domain-specific data — 3× WER improvement in the fintech case.
Speech synthesis: How to choose a model for your task?
| Model |
Latency (TTFB) |
Naturalness MOS |
Cloning |
Languages |
| XTTS v2 |
1.2–2.0 s |
4.1–4.3 |
Yes, 3 s reference |
17 |
| StyleTTS2 |
0.3–0.6 s |
4.0–4.2 |
Yes, requires adaptation |
en, + fine-tune |
| Kokoro-82M |
0.08–0.15 s |
3.7–3.9 |
No |
en, ja |
| Silero TTS |
0.05–0.1 s |
3.4–3.6 |
No |
ru, en, de, etc. |
| Edge-TTS |
~0.4 s (cloud) |
4.0 |
No |
100+ |
For interactive bots requiring TTFB < 300 ms — Silero or Kokoro. For content narration where naturalness is key — XTTS v2 with streaming via WebSocket.
Our process and deliverables
We start with an audit session: take 2–4 hours of your recordings, run them through several models, measure WER/CER, analyze error distribution by type (lexical, acoustic, language). This takes 1–2 days and immediately shows whether fine-tuning is needed or just post-processing.
Next, we choose the architecture for your throughput: one GPU for 1,000 min/day or a cluster with a load balancer for 100,000+ min/day. Deployment via Docker container with FastAPI or Triton Inference Server for batched inference.
What you get after engagement:
- Trained model with model card and evaluation report
- Docker image with optimized inference pipeline
- API documentation and integration examples
- Performance dashboard (Grafana) with latency P99, GPU utilization, WER tracking
- 30-day post-deployment support and hotfixing
Timelines depend on complexity:
- Basic integration of a ready model — 1–2 weeks
- Fine-tuning with data preparation and validation — 4–8 weeks
- Full voice pipeline (ASR + diarization + TTS + monitoring) — 2–4 months
Project investments typically range from $20,000 to $80,000. Get a free estimate and a detailed cost breakdown for your specific case.
Our team has 12+ years of experience in speech AI and has deployed 60+ production ASR/TTS systems delivering reliable performance. Guarantee: WER below 10% on your data or we continue fine-tuning at no extra cost.
Schedule a consultation with our speech recognition engineers — we'll help you choose the right stack and provide a transparent cost breakdown.