aic-sdk 0.16.0

ai-coustics Speech Enhancement SDK
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

use sha2::{Digest, Sha256};
use std::{
    fs::{self, File},
    io::Read,
    path::{Path, PathBuf},
};
use thiserror::Error;

mod manifest;
use manifest::Manifest;

const MODEL_BASE_URL: &str = "https://artifacts.ai-coustics.io/";

#[derive(Debug, Error)]
pub enum Error {
    #[error("I/O error: {0}")]
    Io(String),
    #[error("Failed to download manifest: {0}")]
    ManifestDownload(String),
    #[error("Failed to parse manifest: {0}")]
    ManifestParse(String),
    #[error("Model `{0}` not found in manifest")]
    ModelNotFound(String),
    #[error("Model `{model}` missing compatible version v{compatible_version}")]
    IncompatibleModel {
        model: String,
        compatible_version: u32,
    },
    #[error("Failed to download model file: {0}")]
    ModelDownload(String),
    #[error("Checksum mismatch for downloaded model")]
    ChecksumMismatch,
}

/// Downloads a model file compatible with the provided model version.
///
/// The function fetches the model manifest, checks whether the requested model
/// exists in a version compatible with the given `model_version`, and downloads
/// the model file into the provided directory.
pub fn download<P: AsRef<Path>>(
    model_id: &str,
    model_version: u32,
    download_dir: P,
) -> Result<PathBuf, Error> {
    let manifest = Manifest::download()?;
    let model = manifest.metadata_for_model(model_id, model_version)?;

    let download_dir = download_dir.as_ref();
    fs::create_dir_all(download_dir).map_err(|err| Error::Io(err.to_string()))?;

    let destination = download_dir.join(&model.file_name);
    if destination.exists() && checksum_matches(&destination, &model.checksum)? {
        return Ok(destination);
    }

    let url = format!("{MODEL_BASE_URL}{}", model.url_path);
    let bytes = download_bytes(&url)?;

    let temp_path = destination.with_extension("download");
    fs::write(&temp_path, &bytes).map_err(|err| Error::Io(err.to_string()))?;

    if !checksum_matches(&temp_path, &model.checksum)? {
        let _ = fs::remove_file(&temp_path);
        return Err(Error::ChecksumMismatch);
    }

    fs::rename(&temp_path, &destination).map_err(|err| Error::Io(err.to_string()))?;

    Ok(destination)
}

fn download_bytes(url: &str) -> Result<Vec<u8>, Error> {
    let response = ureq::get(url)
        .call()
        .map_err(|err| Error::ModelDownload(err.to_string()))?;

    response
        .into_body()
        .into_with_config()
        .read_to_vec()
        .map_err(|err| Error::ModelDownload(err.to_string()))
}

fn checksum_matches(path: &Path, expected: &str) -> Result<bool, Error> {
    let mut file = File::open(path).map_err(|err| Error::Io(err.to_string()))?;
    let mut hasher = Sha256::new();
    let mut buffer = [0u8; 8192];

    loop {
        let read = file
            .read(&mut buffer)
            .map_err(|err| Error::Io(err.to_string()))?;
        if read == 0 {
            break;
        }
        hasher.update(&buffer[..read]);
    }

    let checksum = format!("{:x}", hasher.finalize());
    Ok(checksum.eq_ignore_ascii_case(expected))
}