Struct HuggingFaceStorage 

pub struct HuggingFaceStorage { /* private fields */ }

Storage backend for HuggingFace Hub models.

Downloads GGUF models from HuggingFace with progress tracking and checksum verification.

Example

use spn_native::{HuggingFaceStorage, default_model_dir, DownloadRequest, find_model};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let storage = HuggingFaceStorage::new(default_model_dir());
    let model = find_model("qwen3:8b").unwrap();
    let request = DownloadRequest::curated(model);

    let result = storage.download(&request, |p| {
        println!("{}", p);
    }).await?;

    println!("Downloaded: {:?}", result.path);
    Ok(())
}

Implementations

impl HuggingFaceStorage

pub fn new(storage_dir: PathBuf) -> Self

Create a new HuggingFace storage with the given directory.

pub fn with_client(storage_dir: PathBuf, client: Client) -> Self

Create storage with a custom HTTP client.

pub async fn download<F>( &self, request: &DownloadRequest<'_>, progress: F, ) -> Result<DownloadResult>

where F: Fn(PullProgress) + Send + 'static,

Download a model with progress callback.

Arguments

• request - Download request specifying model and quantization
• progress - Callback for download progress updates

Errors

Returns error if:

• Model not found on HuggingFace
• Network error during download
• Checksum verification fails
• I/O error writing file

Trait Implementations

impl ModelStorage for HuggingFaceStorage

fn list_models(&self) -> Result<Vec<ModelInfo>, BackendError>

List downloaded models.

fn exists(&self, model_id: &str) -> bool

Check if a model exists locally.

fn model_info(&self, model_id: &str) -> Result<ModelInfo, BackendError>

Get model info for a specific model.

fn delete(&self, model_id: &str) -> Result<(), BackendError>

Delete a model.

fn model_path(&self, model_id: &str) -> PathBuf

Get the local path for a model.

fn storage_dir(&self) -> &Path

Get the storage root directory.