silero-vad

预训练模型快速判断音频里有没有人说话

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 语音识别 🍴 复刻 877 🐛 待处理 15 👀 关注 70
GitHub ↗
GitHub 星标 ★ 10534
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,MIT许可证

项目预览

silero-vad 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类语音识别
开发团队snakers4
定价模式🏷️完全免费
价格说明开源免费,MIT许可证
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型onnx,onnx-runtime,onnxruntime,pytorch,speech,speech-processing,vad,voice-activity-detection,voice-commands,voice-control,voice-detection,voice-recognition
GitHub 星标★ 10534
上线时间2020-11-23 00:00:00
代码更新2026-10-22
仓库体积120.5 MB
本站数据更新2026-10-27
维护状态活跃
收录时间2026-10-27
浏览次数0

项目介绍

Silero VAD 是一个预训练的企业级语音活动检测(VAD)模型,用于判断音频片段中是否包含人声。它解决语音处理流程中「先切出有效语音、再送入识别或合成」的前置问题,避免静音和噪声浪费算力。核心能力包括:提供 PyTorch 与 ONNX 两种推理形态,支持 ONNX Runtime 部署;单文件模型体积小、推理快,适合实时流式场景;对采样率有明确支持范围,可直接处理短音频块并输出语音概率;附带 Python 调用示例,便于集成到 ASR、语音命令、通话降噪等流水线。项目以预训练权重加轻量代码的方式分发,无需自行标注数据训练,开箱即可用于语音端点检测、长音频切分和静音过滤。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-27 · 当前星标 ★ 10534

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:入门 约 10 分钟 部署方式:库/依赖 6 步

环境要求

  • Python 3.8 及以上版本
  • x86-64 架构,现代 CPU 需支持 AVX、AVX2、AVX-512 或 AMX 指令集
  • 至少 1G 内存
  • 必须安装 torch>=1.12.0,其余依赖通过 extras 可选安装

安装与启动步骤

  1. 1确认 Python 版本

    先确认本机 Python 为 3.8 或更高版本,版本过低会导致依赖无法安装。

    python --version
  2. 2创建虚拟环境

    建议在独立虚拟环境中安装,避免与系统已有 torch 版本冲突。

    python -m venv venv
    source venv/bin/activate
  3. 3安装核心依赖 torch

    torch 是必装依赖,README 要求版本不低于 1.12.0。

    pip install "torch>=1.12.0"
  4. 4安装音频读写支持

    需要 read_audio / save_audio 时安装 audio extra,Python 3.9+ 会同时拉入 torchcodec。

    pip install "silero-vad[audio]"
  5. 5安装 ONNX 推理支持

    使用 ONNX 或序列模型时安装 onnx-cpu extra,含 onnxruntime 与 numpy。

    pip install "silero-vad[onnx-cpu]"
  6. 6一次性安装全部

    想省事可直接装 all extra,会包含上面所有可选依赖。

    pip install "silero-vad[all]"

关键配置

配置项必填说明示例
audio否安装 torchaudio,并在 Python 3.9+ 附带 torchcodec,用于音频读写pip install "silero-vad[audio]"
codec否只安装 torchcodec,完全不依赖 torchaudio 完成音频读写pip install "silero-vad[codec]"
onnx-cpu否安装 CPU 版 onnxruntime 与 numpy,启用 ONNX 推理pip install "silero-vad[onnx-cpu]"
onnx-gpu否安装 GPU 版 onnxruntime 与 numpy,用于 GPU 上的 ONNX 推理pip install "silero-vad[onnx-gpu]"
all否一次装齐上述所有可选依赖pip install "silero-vad[all]"

如何确认成功

执行 python -c "import silero_vad" 无报错,且 pip show silero-vad 能显示版本号,即安装成功。

常见问题

Q:Python 版本不够怎么办?

A:README 要求 Python 3.8+,请先升级解释器再安装,否则依赖解析会失败。

Q:必须有 GPU 吗?

A:不必。CPU 即可运行,只有在需要 GPU 上的 ONNX 推理时才选 onnx-gpu extra。

Q:read_audio 报解码错误?

A:需安装 audio 或 codec extra;Python 3.9+ 上 torchaudio 2.9 起把解码交给 torchcodec,缺少它会失败。

Q:需要自己训练模型吗?

A:不需要。项目以预训练权重加轻量代码方式分发,安装后即可直接使用。

Q:运行时内存不足?

A:README 说明 x86-64 系统需 1G 以上内存,内存过小会导致加载模型失败。

注意事项

  • 只按 README 给出的 extras 方式安装依赖,不要自行替换包名或版本。
  • CPU 需支持 AVX/AVX2/AVX-512/AMX,老旧的 CPU 可能无法运行示例。
  • torch 为必装项,其余依赖均按用途选择 extras,避免安装冗余组件。

核心亮点

  • 提供 PyTorch 和 ONNX 两种权重,ONNX 版可直接用 onnxruntime 部署,跨平台集成成本低
  • 模型体积小、单次推理耗时低,适合实时流式语音端点检测
  • 开箱即用的预训练权重,无需自建标注数据即可做静音过滤和语音切分

不足之处

  • 对采样率等输入格式有约束,使用前需按文档做重采样等预处理
  • 复杂噪声环境下的阈值和参数仍需按场景调优,缺少自动化调参工具

适用场景

  • ASR 前处理:过滤长音频中的静音段,减少识别模型无效计算
  • 实时语音交互:检测用户开始和停止说话,驱动语音助手或语音命令的端点判断
  • 通话与会议录音:切分有效语音片段,便于后续转写、存档和检索

替代项目

webrtcvad、pyannote-audio、VAD(FunASR 内置)

上一篇:home-assistant-voice-pe

下一篇:esp-skainet

同类项目推荐

mimiuchi 开源

在 VR 里动嘴就能打字,语音秒变文字发给任意应用

a free, customizable, osc capable speech-to-text interface for relaying text to diff···

★ 63 2026-08-09
whisper 开源

音频丢进去,多语言文字直接出来

Robust Speech Recognition via Large-Scale Weak Supervision

★ 111300 2026-09-23
TranscriptionSuite 开源

本地跑语音转文字,隐私安全还带说话人分离

A fully local and private Speech-To-Text app, offering multiple model backends, diar···

★ 781 2026-10-04
SmartSpeaker 开源

用STM32+ESP8266自造一台能联网听话的智能音箱

一个基于云端语音识别的智能控制设备,类似于天猫精灵,小爱同学。采用的芯片为stm32f407,···

★ 313 2026-10-03
web-speech-cognitive-services 开源

用Azure服务补齐浏览器语音API,统一标准接入

Polyfill Web Speech API with Cognitive Services for both speech-to-text and text-to-···

★ 70 2026-08-09
openless 开源

按住说话,松开即得润色文字,全应用通用

Hold a key, speak, release — AI-polished text appears at your cursor in any app. Op···

★ 3975 2026-08-09
sherpa-onnx 开源

离线搞定语音识别与合成,支持多端多语言

Speech-to-text, text-to-speech, speaker diarization, speech enhancement, source sepa···

★ 15527 2026-08-09
whisper-asr-webservice 开源

一行命令部署Whisper语音转文字API,快速集成到你的应用

OpenAI Whisper ASR Webservice API

★ 3365 2026-08-10
browser-whisper 开源

浏览器里直接转写音视频,不上传、不花钱

In-browser Whisper speech-to-text with WebGPU (WASM fallback). Transcribe audio & vi···

★ 213 2026-10-12