
whisper-diarization
给语音转写加上说话人标签,会议记录一目了然
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-13 · 当前星标 ★ 5673
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Python >= 3.10(Python 3.9 也能用,但需手动逐个安装依赖)
- 系统已安装 FFMPEG(安装依赖的前置条件)
- 安装依赖前需先准备好 Cython
- 本地运行需有可用 GPU/足够显存(并行脚本要求 >=10GB VRAM)
安装与启动步骤
-
1准备 Python 环境
确认 Python 版本不低于 3.10;若用 3.9,需按 README 提示手动逐个安装依赖,不能直接批量装。
python --version -
2安装 Cython 与 FFMPEG
Cython 与 FFMPEG 是安装依赖的前置条件。Linux 可用 apt 装 cython3,其他平台用 pip 安装。
pip install cython -
3安装项目依赖
README 的安装章节要求先装好 FFMPEG 与 Cython 后再安装依赖,具体依赖清单请按仓库 README 给出的安装命令执行。
-
4运行说话人分离
用 diarize.py 处理音频,-a 后接音频文件名,替换成你自己的文件路径。
python diarize.py -a audio.mp3 -
5高显存并行运行
显存 >=10GB 时可改用并行脚本,NeMo 与 Whisper 同时跑,结果相同但该功能仍为实验性。
python diarize_parallel.py -a audio.mp3 -
6或用 Colab 免装
不想本地配环境,可直接打开 README 中的 Colab Notebook 在云端运行完整示例。
如何确认成功
命令执行结束且无报错,得到带时间戳与说话人标签的转录文本。
常见问题
Q:Python 3.9 可以运行吗?
A:可以运行,但不能直接装依赖,需要按 README 说明手动逐个安装各项依赖,建议直接使用 3.10 及以上版本。
Q:显存不够怎么办?
A:使用 diarize.py 即可;只有显存 >=10GB 时才建议改用 diarize_parallel.py 并行运行。
Q:diarize_parallel.py 报错正常吗?
A:该并行方式在 README 中标为实验性,可能出现错误和边界问题,结果与普通脚本一致,可反馈问题。
Q:不想装本地环境怎么办?
A:可直接打开 README 里的 Colab Notebook,在 Google Colab 中运行 Whisper 转写加 NeMo 说话人分离示例。
注意事项
- FFMPEG 与 Cython 必须先于依赖安装完成,否则依赖装不上。
- diarize.py 与 diarize_parallel.py 结果相同,差别只是并行执行速度。
- 命令中的 audio.mp3 是示例文件名,请替换为真实音频路径。
核心亮点
- 直接复用Whisper的识别结果,无需额外训练,安装配置简单
- 内置说话人分离流程,自动标注说话人,输出带标签的转录文本
- 支持生成字幕文件,方便视频后期制作
不足之处
- 说话人分离效果依赖音频质量和说话人数量,重叠语音场景准确率下降
- 文档和社区支持相对薄弱,问题排查依赖个人经验
适用场景
- 会议录音转写并区分发言人
- 访谈、播客内容整理与字幕生成
- 视频课程或讲座的多说话人内容分析
替代项目
pyannote.audio、SpeechBrain、NVIDIA NeMo
同类项目推荐
VoiceFlow
开源
按快捷键就说话,光标处直接出字,全程离线不上传
Windows 离线语音输入。在当前光标听写,终稿保留在剪贴板与本地历史;无需登录,录音和识···
nodejs-whisper
开源
在 Node.js 里本地跑 Whisper,音频转文字不用 Python
NodeJS Bindings for Whisper - the CPU version of OpenAI's Whisper, as initially craf···
spokestack-python
开源
在嵌入式设备上快速集成离线语音交互,无需云端依赖。
Spokestack is a library that allows a user to easily incorporate a voice interface i···
DayBee
开源
长开麦克风,只转人声,实时出文字
Desktop microphone recorder with real-time, on-device transcription, automatic audio···
transcribe
开源
实时转录+AI回复,模拟外语对话练口语
Transcribe is a real time transcription, conversation, Language learning platform. I···
vibe
开源
本地录音秒变文字,隐私不泄露
Transcribe on your own!
CrisperWhisper
开源
让 Whisper 转写更精确,词级时间戳和语气词全搞定
Controllable Transcription. Verbatim ( every, filler, pause, stutter, vocal sound) ,···
AuxiliaryASR
开源
给语音合成和转换提供精准的文本-音频对齐工具
Joint CTC-S2S Phoneme-level ASR for Voice Conversion and TTS (Text-Mel Alignment)
WhisperJAV
开源
给JAV视频一键生成高准确率字幕,嘈杂环境也能听清
ASR/STT subtitle generator. Uses Qwen3-ASR, local LLM, Whisper, TEN-VAD. Noise-robus···