whisper-macos-cli 0.1.2

Transcribe audio files locally on Apple Silicon via whisper.cpp with Metal GPU acceleration, exposing a strict stdin/stdout JSON contract for AI agents and Unix pipelines.
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

pub struct ModelInfo {
    pub name: &'static str,
    pub filename: &'static str,
    pub url: &'static str,
    pub size_bytes: u64,
    pub description: &'static str,
    pub min_size_bytes: u64,
}

static MODELS: &[ModelInfo] = &[
    ModelInfo {
        name: "tiny",
        filename: "ggml-tiny.bin",
        url: "https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-tiny.bin",
        size_bytes: 75_687_065,
        min_size_bytes: 70_000_000,
        description: "Fastest, lowest accuracy",
    },
    ModelInfo {
        name: "base",
        filename: "ggml-base.bin",
        url: "https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.bin",
        size_bytes: 142_356_480,
        min_size_bytes: 135_000_000,
        description: "Fast, basic accuracy",
    },
    ModelInfo {
        name: "small",
        filename: "ggml-small.bin",
        url: "https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-small.bin",
        size_bytes: 466_041_792,
        min_size_bytes: 440_000_000,
        description: "Balanced speed/accuracy",
    },
    ModelInfo {
        name: "medium",
        filename: "ggml-medium.bin",
        url: "https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-medium.bin",
        size_bytes: 1_524_630_880,
        min_size_bytes: 1_400_000_000,
        description: "High accuracy",
    },
    ModelInfo {
        name: "large-v3",
        filename: "ggml-large-v3.bin",
        url: "https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3.bin",
        size_bytes: 3_095_033_856,
        min_size_bytes: 2_900_000_000,
        description: "Maximum accuracy (default)",
    },
];

pub fn get_model(name: &str) -> Option<&'static ModelInfo> {
    MODELS.iter().find(|m| m.name == name)
}

pub fn default_model() -> &'static ModelInfo {
    match get_model("large-v3") {
        Some(m) => m,
        None => &MODELS[MODELS.len() - 1],
    }
}

pub fn all_models() -> &'static [ModelInfo] {
    MODELS
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn default_model_is_large_v3() {
        assert_eq!(default_model().name, "large-v3");
    }

    #[test]
    fn get_model_tiny_returns_some() {
        assert!(get_model("tiny").is_some());
    }

    #[test]
    fn get_model_nonexistent_returns_none() {
        assert!(get_model("nonexistent").is_none());
    }

    #[test]
    fn all_models_returns_five() {
        assert_eq!(all_models().len(), 5);
    }

    #[test]
    fn min_size_is_less_than_total_size() {
        for m in all_models() {
            assert!(
                m.min_size_bytes < m.size_bytes,
                "min_size must be smaller than expected size for {}",
                m.name
            );
        }
    }
}