
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-27 · 当前星标 ★ 10534
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Python 3.8 及以上版本
- x86-64 架构,现代 CPU 需支持 AVX、AVX2、AVX-512 或 AMX 指令集
- 至少 1G 内存
- 必须安装 torch>=1.12.0,其余依赖通过 extras 可选安装
安装与启动步骤
-
1确认 Python 版本
先确认本机 Python 为 3.8 或更高版本,版本过低会导致依赖无法安装。
python --version -
2创建虚拟环境
建议在独立虚拟环境中安装,避免与系统已有 torch 版本冲突。
python -m venv venv source venv/bin/activate -
3安装核心依赖 torch
torch 是必装依赖,README 要求版本不低于 1.12.0。
pip install "torch>=1.12.0" -
4安装音频读写支持
需要 read_audio / save_audio 时安装 audio extra,Python 3.9+ 会同时拉入 torchcodec。
pip install "silero-vad[audio]" -
5安装 ONNX 推理支持
使用 ONNX 或序列模型时安装 onnx-cpu extra,含 onnxruntime 与 numpy。
pip install "silero-vad[onnx-cpu]" -
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 内置)
下一篇:esp-skainet
同类项目推荐
mimiuchi
开源
在 VR 里动嘴就能打字,语音秒变文字发给任意应用
a free, customizable, osc capable speech-to-text interface for relaying text to diff···
whisper
开源
音频丢进去,多语言文字直接出来
Robust Speech Recognition via Large-Scale Weak Supervision
TranscriptionSuite
开源
本地跑语音转文字,隐私安全还带说话人分离
A fully local and private Speech-To-Text app, offering multiple model backends, diar···
SmartSpeaker
开源
用STM32+ESP8266自造一台能联网听话的智能音箱
一个基于云端语音识别的智能控制设备,类似于天猫精灵,小爱同学。采用的芯片为stm32f407,···
web-speech-cognitive-services
开源
用Azure服务补齐浏览器语音API,统一标准接入
Polyfill Web Speech API with Cognitive Services for both speech-to-text and text-to-···
openless
开源
按住说话,松开即得润色文字,全应用通用
Hold a key, speak, release — AI-polished text appears at your cursor in any app. Op···
sherpa-onnx
开源
离线搞定语音识别与合成,支持多端多语言
Speech-to-text, text-to-speech, speaker diarization, speech enhancement, source sepa···
whisper-asr-webservice
开源
一行命令部署Whisper语音转文字API,快速集成到你的应用
OpenAI Whisper ASR Webservice API
browser-whisper
开源
浏览器里直接转写音视频,不上传、不花钱
In-browser Whisper speech-to-text with WebGPU (WASM fallback). Transcribe audio & vi···