Struct HuggingFaceSource 

pub struct HuggingFaceSource { /* private fields */ }

Hugging Face implementation of voxora_traits::ModelSource.

Cheap to clone (every field is Arc-shared), so callers should hold it as Arc<HuggingFaceSource> and pass clones around.

Implementations

impl HuggingFaceSource

pub fn new() -> Result<Self, AsrError>

Construct a source with sensible defaults.

• Cache root: $XDG_CACHE_HOME/voxora/models/huggingface.
• Base URL: https://huggingface.co.
• Token: HF_TOKEN then HUGGING_FACE_HUB_TOKEN (first non-empty wins).
• User-Agent: voxora-hf/<version>.
• Timeout: 600 s per request.

pub fn builder() -> HuggingFaceSourceBuilder

Start configuring a source with non-default options.

Trait Implementations

impl Clone for HuggingFaceSource

fn clone(&self) -> HuggingFaceSource

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HuggingFaceSource

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl ModelSource for HuggingFaceSource

fn name(&self) -> &'static str

Short, stable identifier for this source ("huggingface", "local", …).

fn resolve<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, model_id: &'life1 str, opts: &'life2 ResolveOptions, ) -> Pin<Box<dyn Future<Output = Result<ModelDir, AsrError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Resolve a model id (e.g. Qwen/Qwen3-ASR-0.6B) to a concrete ModelDir on disk, downloading if necessary.

fn capabilities_for<'life0, 'life1, 'async_trait>( &'life0 self, model_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<ModelCapabilities, AsrError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Query a model’s capabilities without downloading the weights.

fn list_available<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<ModelDescriptor>, AsrError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

List models known to this source. Defaults to AsrError::Unsupported because not every source can enumerate.