fasr-vad-silero

英文文档地址: README_EN.md

Silero 流式 VAD 插件。官方 TorchScript 权重随包分发，启动时不依赖 torch.hub 或网络下载，并封装为 fasr 的流式 VADModel，输出带有 segment_start、segment_mid、segment_end 状态的 AudioChunk。

安装

pip install fasr-vad-silero

注册模型

流式使用

from fasr.config import registry

vad = registry.vad_models.get("silero")(
    threshold=0.5,
    silence_duration_ms=500,
)

for input_chunk in audio_chunks:
    for speech_chunk in vad.push_chunk(input_chunk):
        print(speech_chunk.vad_state, speech_chunk.start_ms, speech_chunk.end_ms)

批量使用

from fasr.data import AudioSpan

segments = vad.detect(
    AudioSpan(
        start_ms=0,
        waveform=waveform,
    )
)

detect(...) 会把整段音频按流式路径重放一遍，因此批量分段和实时模式共享同一套 阈值、prefix padding 与端点规则。

Confection 配置

[vad_model]
@vad_models = "silero"
threshold = 0.5
silence_duration_ms = 500
prefix_padding_ms = 0
sample_rate = 16000
chunk_size_ms = 32

参数

调参建议

运行时断句更新

silero 支持通过 apply_turn_detection(...) 做实时断句参数更新。 这个接口主要给 websocket 这类长连接会话使用。

当前支持的运行时参数：

• silence_duration_ms
• threshold
• prefix_padding_ms

prefix_padding_ms 在 wrapper 状态机层实现：第一次检测到语音时，会把输出片段 起点按设定值向前回退，并在已有缓冲音频范围内做裁剪。

依赖

• fasr
• numpy >= 1.24
• torch >= 2.0.0
• Python 3.10-3.12