wavekat-turn 0.0.4

Unified turn detection for voice pipelines, wrapping multiple open-source models behind common Rust traits. Same pattern as wavekat-vad.

[!WARNING] Early development. Trait API is defined; backend implementations are stubs pending ONNX model integration.

Backends

Quick Start

cargo add wavekat-turn --features pipecat

Use the audio-based detector:

use wavekat_turn::{AudioTurnDetector, TurnState};
use wavekat_turn::audio::PipecatSmartTurn;

let mut detector = PipecatSmartTurn::new()?;

// Feed 16 kHz f32 PCM frames after VAD detects silence
let prediction = detector.predict_audio(&audio_frames)?;

match prediction.state {
    TurnState::Finished   => { /* user is done, send to LLM */ }
    TurnState::Unfinished => { /* keep listening */ }
    TurnState::Wait       => { /* user asked AI to hold */ }
}

Or the text-based detector:

use wavekat_turn::{TextTurnDetector, TurnState};
use wavekat_turn::text::LiveKitEou;

let mut detector = LiveKitEou::new()?;

let prediction = detector.predict_text("I was wondering if", &context)?;
assert_eq!(prediction.state, TurnState::Unfinished);

Architecture

Two trait families cover the two input modalities:

• AudioTurnDetector -- operates on raw audio frames (no ASR needed)
• TextTurnDetector -- operates on ASR transcript text with optional conversation context

wavekat-vad   -->  "is someone speaking?"
wavekat-turn  -->  "are they done speaking?"
     |                   |
     v                   v
wavekat-voice -->  orchestrates VAD + turn + ASR + LLM + TTS

Feature Flags

Important Notes

• 8 kHz telephony audio must be upsampled to 16 kHz before passing to audio-based detectors. Smart Turn v3 silently produces incorrect results at 8 kHz.
• Text-based detectors depend on ASR transcript quality. Pair with a streaming ASR provider for best results.

License

Licensed under Apache 2.0.

Copyright 2026 WaveKat.

Acknowledgements

• Pipecat Smart Turn by Daily (BSD 2-Clause)
• LiveKit Turn Detector by LiveKit (LiveKit Model License)