Repolode
pyannote

pyannote/pyannote-audio

基于 PyTorch 的开源 Python 说话人分离工具包,提供预训练模型与流水线,用于识别音频中谁在何时说话。

Star
10,671
Fork
1,123
未关闭 Issue
48
最近提交
12小时前

这是什么?

pyannote.audio 是一个用于说话人分离(speaker diarization)的 Python 工具包,即按说话人切分音频,判断每段语音由谁在何时说出。它基于 PyTorch 构建,提供可本地运行、也可用自有数据微调的预训练流水线和模型。

工具包涵盖说话人分离的基础模块,包括语音活动检测、说话人切换检测、重叠语音检测和说话人向量提取。开源流水线 community-1 可通过几行 Python 从 Hugging Face 加载,输出带时间戳的说话人片段。付费流水线 precision-2 则通过 API 密钥在 pyannoteAI 服务器上运行。遥测功能可通过环境变量关闭。

训练部分借助 pytorch-lightning 支持多 GPU。项目还提供了应用预训练流水线、适配自有数据以及训练模型的教程。

核心功能

  • 01可从 Hugging Face 加载的预训练说话人分离流水线
  • 02语音活动、说话人切换和重叠语音检测模型
  • 03用于说话人验证与识别的说话人向量提取
  • 04借助 pytorch-lightning 支持多 GPU 训练,可用自有数据微调
  • 05可选通过 pyannoteAI API 调用的付费高精度流水线

适用场景

  • 为会议或访谈转写结果添加说话人标签
  • 按说话人分析客服通话或播客录音
  • 研究和评测说话人分离模型
  • 将分离模型适配到特定语言或领域

快速上手

  1. 1

    确保本机已安装 ffmpeg

  2. 2

    使用 uv 安装(推荐)

    uv add pyannote.audio
  3. 3

    在 Hugging Face 上接受 pyannote/speaker-diarization-community-1 的用户条款并创建访问令牌

  4. 4

    加载 community-1 流水线并对音频文件运行

使用前须知

  • 开源的 community-1 流水线需要接受模型使用条款并提供 Hugging Face 访问令牌。
  • 在 GPU 上运行速度更快,README 中的基准测试使用的是 NVIDIA H100。
  • 高级服务 precision-2 需要 pyannoteAI API 密钥,托管使用时在 pyannoteAI 服务器上运行。

标签

常见问题

pyannote-audio 是什么?
基于 PyTorch 的开源 Python 说话人分离工具包,提供预训练模型与流水线,用于识别音频中谁在何时说话。 pyannote.audio 是一个用于说话人分离(speaker diarization)的 Python 工具包,即按说话人切分音频,判断每段语音由谁在何时说出。它基于 PyTorch 构建,提供可本地运行、也可用自有数据微调的预训练流水线和模型。
pyannote-audio 可以免费使用吗?用的什么许可证?
pyannote-audio 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
pyannote-audio 还在维护吗?
活跃维护中。pyannote-audio 最近一次提交是在 2026年10月20日。
pyannote-audio 适合用来做什么?
为会议或访谈转写结果添加说话人标签 按说话人分析客服通话或播客录音 研究和评测说话人分离模型 将分离模型适配到特定语言或领域
pyannote-audio 怎么安装和运行?
确保本机已安装 ffmpeg 使用 uv 安装(推荐): uv add pyannote.audio 在 Hugging Face 上接受 pyannote/speaker-diarization-community-1 的用户条款并创建访问令牌 加载 community-1 流水线并对音频文件运行
在哪里获取 pyannote-audio?
源代码和安装说明在 GitHub 上:https://github.com/pyannote/pyannote-audio

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目