Turn detector plugin for LiveKit Agents
⚠️ Deprecated. This plugin is deprecated and will be removed in a future release. Use
livekit.agents.inference.TurnDetectorinstead — it ships withlivekit-agents, requires no additional install, and replaces both the English and Multilingual text-based models with a unified audio end-of-turn detector.
This plugin introduces end-of-turn detection for LiveKit Agents using a custom open-weight model to determine when a user has finished speaking.
Traditional voice agents use VAD (voice activity detection) for end-of-turn detection. However, VAD models lack language understanding, often causing false positives where the agent interrupts the user before they finish speaking.
By leveraging a language model specifically trained for this task, this plugin offers a more accurate and robust method for detecting end-of-turns.
See https://docs.livekit.io/agents/build/turns/turn-detector/ for more information.
Usage
The recommended replacement is TurnDetector, available from livekit-agents directly:
from livekit.agents.inference import TurnDetector
session = AgentSession(
...
turn_detection=TurnDetector(),
)
Usage with RealtimeModel
TurnDetector works with speech-to-speech models such as OpenAI's Realtime API:
session = AgentSession(
...
llm=openai.realtime.RealtimeModel(),
turn_detection=TurnDetector(),
)
Running your agent
This plugin requires model files. Before starting your agent for the first time, or when building Docker images for deployment, run the following command to download the model files:
python -m livekit.agents download-files
Downloaded model files
Model files are downloaded to and loaded from the location specified by the HF_HUB_CACHE environment variable. If not set, this defaults to $HF_HOME/hub (typically ~/.cache/huggingface/hub).
For offline deployment, download the model files first while connected to the internet, then copy the cache directory to your deployment environment.
Model system requirements
The end-of-turn model is optimized to run on CPUs with modest system requirements. It is designed to run on the same server hosting your agents.
The model requires <500MB of RAM and runs within a shared inference server, supporting multiple concurrent sessions.
License
The plugin source code is licensed under the Apache-2.0 license.
The end-of-turn model is licensed under the LiveKit Model License.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file livekit_plugins_turn_detector-1.6.7.tar.gz.
File metadata
- Download URL: livekit_plugins_turn_detector-1.6.7.tar.gz
- Upload date:
- Size: 7.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cc34e7ff269ffba4aeb4662975c18d789981657ecedfb1f4437376ece03c129c
|
|
| MD5 |
5b282c34408545510dddf1cbf5403db6
|
|
| BLAKE2b-256 |
2e3815d5938f38cc07227cba0efcaef7bd1fdba920579bc69fcbdc6bb4fc7742
|
Provenance
The following attestation bundles were made for livekit_plugins_turn_detector-1.6.7.tar.gz:
Publisher:
publish.yml on livekit/agents
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
livekit_plugins_turn_detector-1.6.7.tar.gz -
Subject digest:
cc34e7ff269ffba4aeb4662975c18d789981657ecedfb1f4437376ece03c129c - Sigstore transparency entry: 2241465567
- Sigstore integration time:
-
Permalink:
livekit/agents@48c179329522a44a979c97f58865773badf5241f -
Branch / Tag:
refs/heads/main - Owner: https://github.com/livekit
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@48c179329522a44a979c97f58865773badf5241f -
Trigger Event:
pull_request
-
Statement type:
File details
Details for the file livekit_plugins_turn_detector-1.6.7-py3-none-any.whl.
File metadata
- Download URL: livekit_plugins_turn_detector-1.6.7-py3-none-any.whl
- Upload date:
- Size: 10.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
477ac22ffb000d51636f05fa31236e2d59c764e749e43567e893e724ba0e0e6a
|
|
| MD5 |
ee4131d1c656a4c792d8ed5bdf0f969f
|
|
| BLAKE2b-256 |
63b340a04bc3bc5b398df4b0f4859d96a95e4d8c3929fe25f4d4755fcf36ff68
|
Provenance
The following attestation bundles were made for livekit_plugins_turn_detector-1.6.7-py3-none-any.whl:
Publisher:
publish.yml on livekit/agents
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
livekit_plugins_turn_detector-1.6.7-py3-none-any.whl -
Subject digest:
477ac22ffb000d51636f05fa31236e2d59c764e749e43567e893e724ba0e0e6a - Sigstore transparency entry: 2241466425
- Sigstore integration time:
-
Permalink:
livekit/agents@48c179329522a44a979c97f58865773badf5241f -
Branch / Tag:
refs/heads/main - Owner: https://github.com/livekit
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@48c179329522a44a979c97f58865773badf5241f -
Trigger Event:
pull_request
-
Statement type:
