rlx-vad 0.2.5

Voice activity detection (Earshot + Silero) on RLX
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

// RLX — versatile ML compiler + runtime.
// Copyright (C) 2026 Eugene Hauptmann, Nataliya Kosmyna.
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, version 3.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program. If not, see <https://www.gnu.org/licenses/>.

//! Voice activity detection on RLX (Earshot + Silero architectures).
//!
//! Enable backends via features: `earshot`, `silero` (both on by default).

pub mod audio;
pub mod device;
pub mod ops;
pub mod segments;

#[cfg(feature = "earshot")]
pub mod earshot;

#[cfg(feature = "silero")]
pub mod silero;

pub use audio::{
    SAMPLE_RATE_16K, SpeechSegment, load_wav_mono_f32, parse_wav_mono_f32, resample_linear,
};
pub mod cli;

pub use device::{
    available_device_labels, available_devices, bench_device_label, ensure_backend_ready,
    parse_device_list, resolve_device, streaming_execution_device,
};
pub use segments::SegmentParams;
#[cfg(feature = "earshot")]
pub use segments::speech_segments_earshot;
#[cfg(feature = "silero")]
pub use segments::speech_segments_silero;

#[cfg(feature = "earshot")]
pub use earshot::Detector as EarshotDetector;

#[cfg(feature = "silero")]
pub use silero::{SileroConfig, SileroSession, SileroWeights};

/// Backends compiled into this crate (from Cargo features).
pub fn enabled_backends() -> &'static [&'static str] {
    &[
        #[cfg(feature = "earshot")]
        "earshot",
        #[cfg(feature = "silero")]
        "silero",
    ]
}

/// Default `--backend` for the CLI (first enabled backend).
pub fn default_backend() -> &'static str {
    #[cfg(feature = "earshot")]
    {
        "earshot"
    }
    #[cfg(all(not(feature = "earshot"), feature = "silero"))]
    {
        "silero"
    }
    #[cfg(not(any(feature = "earshot", feature = "silero")))]
    {
        "none"
    }
}

/// Supported PCM sample rates for Silero.
#[cfg(feature = "silero")]
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum SampleRate {
    Hz8000,
    Hz16000,
}

#[cfg(feature = "silero")]
impl SampleRate {
    pub const fn as_usize(self) -> usize {
        match self {
            Self::Hz8000 => 8_000,
            Self::Hz16000 => 16_000,
        }
    }

    pub fn from_hz(hz: usize) -> anyhow::Result<Self> {
        match hz {
            8_000 => Ok(Self::Hz8000),
            16_000 => Ok(Self::Hz16000),
            _ => anyhow::bail!("unsupported sample rate {hz} (Silero supports 8000 and 16000)"),
        }
    }
}