voice-core

Shared low-level audio primitives for the kevin voice service and the autonet (autonet-computer[voice]) VoiceService. Both repos used to carry their own copy of this code; this package is the single source of truth so fixes land once.

What's here

What's not here

Architecture-specific glue stays in each repo:

• kevin: UDP instance registry, hooks, window focus, clipboard paste, overlay, main()
• autonet: VoiceService class, EventBus wiring, VoiceConfig

Install

pip install -e .            # core only (numpy + sounddevice)
pip install -e .[full]      # all TTS backends + PTT/STT

Heavy deps (kokoro-onnx, edge-tts, miniaudio, requests, keyboard, faster-whisper) are lazy-imported, so the core imports cheaply and each backend only errors (with an install hint) when used without its dependency.

Configuring model/voice paths

The Kokoro model files (kokoro-v1.0.onnx, voices-v1.0.bin) and the Piper voice package live outside this repo. Point at them at startup:

import voice_core
voice_core.set_kokoro_model_dir(r"c:\code\kevin")   # holds the .onnx + .bin
voice_core.set_piper_module_dir(r"c:\code\voice")   # holds the `voice` package