use super::model_error;
#[cfg(all(feature = "backend-sherpa", feature = "punct-sherpa"))]
use super::punctuation_error;
use crate::{AsrError, StreamingConfig};
#[cfg(feature = "vad-silero")]
use crate::{OfflineFamily, SpeechHints, TransducerBiasConfig};
fn validate_num_threads(num_threads: usize) -> Result<(), AsrError> {
if num_threads == 0 || num_threads > crate::MAX_NUM_THREADS {
return Err(AsrError::invalid(format!(
"num_threads must be between 1 and {}",
crate::MAX_NUM_THREADS
)));
}
Ok(())
}
pub(crate) fn validate_provider(provider: crate::ExecutionProvider) -> Result<(), AsrError> {
use crate::ExecutionProvider;
let supported = match provider {
ExecutionProvider::Cpu => true,
ExecutionProvider::Cuda => cfg!(any(target_os = "linux", target_os = "windows")),
ExecutionProvider::CoreMl => cfg!(target_vendor = "apple"),
};
if !supported {
return Err(AsrError::new(
crate::ErrorKind::UnsupportedCapability,
"configuration",
format!(
"provider {} is unsupported on this platform",
provider.as_str()
),
));
}
Ok(())
}
#[cfg(feature = "backend-sherpa")]
pub(crate) fn streaming(config: &StreamingConfig) -> Result<(), AsrError> {
validate_num_threads(config.num_threads)?;
validate_provider(config.provider)?;
let files = super::model_layout::find_model_files(&config.model_dir).map_err(model_error)?;
if let Some(bias) = &config.bias {
super::hotwords::prepare_bias(bias, &files)?;
}
validate_punct(config.punctuation.as_ref())
}
#[cfg(feature = "vad-silero")]
pub(crate) fn validate_family_parameters(
family: OfflineFamily,
language: Option<&str>,
bias: Option<&TransducerBiasConfig>,
prompt_hints: Option<&SpeechHints>,
) -> Result<(), AsrError> {
match family {
OfflineFamily::SenseVoice | OfflineFamily::Paraformer => {
if bias.is_some() || prompt_hints.is_some() {
return Err(AsrError::new(
crate::ErrorKind::UnsupportedCapability,
"configuration",
format!("{family:?} does not support speech hints or transducer bias"),
));
}
if let Some(language) = language {
match family {
OfflineFamily::SenseVoice => {
if !["auto", "zh", "en", "ja", "ko", "yue"].contains(&language) {
return Err(AsrError::invalid("unsupported SenseVoice language"));
}
}
_ => {
return Err(AsrError::invalid(
"Paraformer does not accept a language override",
));
}
}
}
}
OfflineFamily::Transducer => {
if language.is_some() {
return Err(AsrError::invalid(
"Transducer does not accept a language override",
));
}
if prompt_hints.is_some() {
return Err(AsrError::new(
crate::ErrorKind::UnsupportedCapability,
"configuration",
"Transducer does not support engine-level prompt hints",
));
}
}
OfflineFamily::Qwen3Asr | OfflineFamily::FunAsrNano => {
if language.is_some() {
return Err(AsrError::invalid(format!(
"{family:?} does not accept a language override"
)));
}
if bias.is_some() {
return Err(AsrError::new(
crate::ErrorKind::UnsupportedCapability,
"configuration",
format!("{family:?} does not support transducer bias"),
));
}
}
OfflineFamily::FireRedAsrAed | OfflineFamily::FireRedAsrCtc => {
if bias.is_some() || prompt_hints.is_some() {
return Err(AsrError::new(
crate::ErrorKind::UnsupportedCapability,
"configuration",
format!("{family:?} does not support speech hints or transducer bias"),
));
}
if language.is_some() {
return Err(AsrError::invalid(format!(
"{family:?} does not accept a language override"
)));
}
}
}
Ok(())
}
#[cfg(all(feature = "backend-sherpa", feature = "vad-silero"))]
pub(crate) fn offline(config: &crate::OfflineConfig) -> Result<(), AsrError> {
validate_num_threads(config.num_threads)?;
validate_provider(config.provider)?;
super::vad::validate(&config.vad)?;
validate_family_parameters(
config.family,
config.language.as_deref(),
config.transducer_bias.as_ref(),
config.prompt_hints.as_ref(),
)?;
match config.family {
OfflineFamily::SenseVoice | OfflineFamily::Paraformer | OfflineFamily::FireRedAsrCtc => {
let files = super::model_layout::find_offline_model_files(&config.model_dir)
.map_err(model_error)?;
super::model_layout::ensure_family_not_contradicted(config.family, &files.tokens)
.map_err(model_error)?;
}
OfflineFamily::FireRedAsrAed => {
super::model_layout::find_fire_red_aed_files(&config.model_dir).map_err(model_error)?;
}
OfflineFamily::Transducer => {
let files =
super::model_layout::find_model_files(&config.model_dir).map_err(model_error)?;
if let Some(bias) = &config.transducer_bias {
super::hotwords::prepare_bias(bias, &files)?;
}
}
OfflineFamily::Qwen3Asr => {
super::model_layout::find_qwen3_files(&config.model_dir).map_err(model_error)?;
}
OfflineFamily::FunAsrNano => {
super::model_layout::find_funasr_nano_files(&config.model_dir).map_err(model_error)?;
}
}
if let Some(hints) = &config.prompt_hints {
match config.family {
OfflineFamily::Qwen3Asr => {
super::hotwords::qwen3_prompt(hints)?;
}
OfflineFamily::FunAsrNano => {
super::hotwords::funasr_nano_prompt(hints)?;
}
_ => {}
}
}
validate_punct(config.punctuation.as_ref())
}
#[cfg(all(feature = "backend-sherpa", feature = "punct-sherpa"))]
fn validate_punct(config: Option<&crate::PunctConfig>) -> Result<(), AsrError> {
match config {
Some(config) => super::model_layout::find_punct_model_files(&config.model)
.map_err(punctuation_error)
.map(|_| ()),
None => Ok(()),
}
}
#[cfg(all(feature = "backend-sherpa", not(feature = "punct-sherpa")))]
fn validate_punct(config: Option<&crate::PunctConfig>) -> Result<(), AsrError> {
if config.is_some() {
return Err(AsrError::new(
crate::ErrorKind::UnsupportedCapability,
"configuration",
"punctuation support is disabled in this build",
));
}
Ok(())
}