🚀 Install

GPU

pip install fennec-voice

CPU only (smaller download)

pip install torch --index-url https://download.pytorch.org/whl/cpu
pip install fennec-voice

The GPU is used automatically when available.

🧩 Use

from fennec_voice import FennecInterrupt, FennecHandoff

interrupt = FennecInterrupt()
result = interrupt.predict(
    said="Your flight from Mumbai to Delhi is",
    unsaid="on the seventeenth of October.",
    caller="mm hmm",
)
print(result.label, result.p_stop)
# BACKCHANNEL 0.002

handoff = FennecHandoff()
result = handoff.predict("I want to fly from Mumbai to um")
print(result.finished, result.p_unfinished)
# False 0.99

• said: the agent's words the caller had heard. unsaid: the rest of the agent's sentence. caller: what the caller said.
• predict_batch([...]) runs many inputs in one pass.
• Results have .to_dict().

Labels (interrupt.labels): BACKCHANNEL (a nod: keep talking) and, for stop and listen: ACK_AFTER_QUESTION, ANSWER, QUESTION, CORRECTION, STOP_REQUEST, HOLD_REQUEST, CANT_HEAR, PICKUP_GREETING, TAKES_TURN.

⚙️ Options

FennecInterrupt(
    model="latest",      # or "fennec-interrupt-150m-v1", a Hugging Face repo id, or a local folder
    device="auto",       # "cuda" or "cpu"
    fp16=None,           # default: on for GPU
    threads=None,        # CPU threads
    revision=None,       # pin exact model files (Hugging Face commit or tag)
)
FennecHandoff(..., threshold=0.5)   # p_unfinished at or above it means "not finished"

import fennec_voice
fennec_voice.list_models()   # all known models

The package and the models have separate versions: new models arrive as new names, and "latest" only moves to a better default. Pin a name for stable behaviour.

▶️ Demo

fennec-voice-demo: a full local voice agent built around these two models, one ./run.sh.

💡 Good to know

• English only.
• "okay" can mean "I'm listening" or "yes": right before the agent's yes/no question it counts as "yes".
• v1, a hobby project: expect rough edges.

📄 License

Apache-2.0. The input formatter comes from ozonetg/bargein-classifier-ettin-150m (MIT), see NOTICE.