brainwires-hardware 0.9.0

Hardware I/O for the Brainwires Agent Framework — audio, GPIO, Bluetooth, and network
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

use async_trait::async_trait;
use futures::stream::BoxStream;

use crate::audio::error::AudioResult;
use crate::audio::types::{AudioBuffer, SttOptions, Transcript};

/// Converts audio to text (speech-to-text / transcription).
#[async_trait]
pub trait SpeechToText: Send + Sync {
    /// Get the name of this STT backend (e.g., "openai-whisper", "whisper-local").
    fn name(&self) -> &str;

    /// Transcribe a complete audio buffer to text.
    async fn transcribe(
        &self,
        audio: &AudioBuffer,
        options: &SttOptions,
    ) -> AudioResult<Transcript>;

    /// Transcribe audio from a stream in real-time, yielding partial transcripts.
    ///
    /// Each yielded [`Transcript`] may be a partial result that gets refined
    /// as more audio arrives. The final transcript has the complete text.
    ///
    /// Not all backends support streaming; those that don't should buffer
    /// internally and yield a single final result.
    fn transcribe_stream(
        &self,
        audio_stream: BoxStream<'static, AudioResult<AudioBuffer>>,
        options: &SttOptions,
    ) -> BoxStream<'static, AudioResult<Transcript>>;
}