aurum-core

Reusable on-device speech I/O library for Aurum.

Speech both ways. On-device by default.

• Local whisper.cpp STT (whisper-rs, Metal on macOS)
• Local ONNX TTS (KittenTTS / Kokoro; feature tts, default on)
• Optional remote providers (OpenRouter / OpenAI / ElevenLabs / xAI)
• PCM-first mic host API · partial-window helpers · cancel
• Cleanup / flow (rules or OpenRouter)
• Model download, pins, txt/srt/json

API status: provisional on continuous 0.0.x (next assurance cut v0.0.21, not 1.0). Pin a crates.io version or git tag.

Depend

aurum-core = "0.0.21"
# STT only (smaller): default-features = false
# git: tag = "v0.0.21"
tokio = { version = "1", features = ["rt-multi-thread", "macros"] }

Quick STT example

use aurum_core::audio::load_audio;
use aurum_core::providers::{LocalWhisperProvider, TranscriptionOptions};

# async fn demo() -> aurum_core::Result<()> {
let audio = load_audio(std::path::Path::new("meeting.m4a")).await?;
let provider = LocalWhisperProvider::new(std::path::PathBuf::from("/tmp/aurum-cache"))
    .with_progress(false);
let result = provider
    .transcribe(
        &audio,
        &TranscriptionOptions {
            model: "tiny-q5_1".into(),
            language: "en".into(),
            timestamps: false,
            cancel: None,
        },
    )
    .await?;
println!("{}", result.text());
aurum_core::providers::local::clear_context_cache();
# Ok(())
# }

Prefer AurumEngine for long-lived hosts (owned pools, governor, registry). See the integration guide.

License

MIT