Gladia plugin for LiveKit Agents
Support for speech-to-text with Gladia.
See https://docs.livekit.io/agents/integrations/stt/gladia/ for more information.
Installation
pip install livekit-plugins-gladia
Pre-requisites
You'll need an API key from Gladia. It can be set as an environment variable: GLADIA_API_KEY
Features
- Streaming speech-to-text
- Multi-language support
- Code-switching between languages
- Interim results (partial transcriptions)
- Voice activity detection with energy filtering
- Optional real-time translation
- Customizable audio parameters (sample rate, bit depth, channels, encoding)
Example Usage
from livekit.stt import STT
from livekit.plugins.gladia.stt import STT as GladiaSTT
# Basic initialization
stt = GladiaSTT(
api_key="your-api-key-here", # or use GLADIA_API_KEY env var
interim_results=True
)
# With more options
stt = GladiaSTT(
languages=["en", "fr"], # Specify languages or let Gladia auto-detect
code_switching=True, # Allow switching between languages during recognition
sample_rate=16000, # Audio sample rate in Hz
bit_depth=16, # Audio bit depth
channels=1, # Number of audio channels
region="eu-west" # Specify Region to use for the Gladia API
encoding="wav/pcm", # Audio encoding format
energy_filter=True, # Enable voice activity detection
translation_enabled=True,
translation_target_languages=["en"],
translation_model="base",
translation_match_original_utterances=True
translation_context_adaptation= False, # Enable context-aware translation
translation_context= None, # Context input to guide translation
translation_informal=False, # Use informal tone in translation
pre_processing_audio_enhancer=False, # Apply pre-processing to the audio stream to enhance the quality
pre_processing_speech_threshold=0.6, # Sensitivity for speech detection; closer to 1 = stricter, less background noise
# Custom_vocabulary exemple
custom_vocabulary=[
"Westeros",
{"value": "Stark"},
{
"value": "Night's Watch",
"pronunciations": ["Nightz Watch"],
"intensity": 0.4,
"language": "en"
}
],
# Custom_spelling exemple
custom_spelling={
"Gorish": ["ghorish", "gaurish", "gaureish"],
"Data Science": ["data-science", "data science"],
".": ["period", "full stop"],
"SQL": ["sequel"]
}
)
# Update options after initialization
stt.update_options(
languages=["ja", "en"],
translation_enabled=True,
translation_target_languages=["fr"]
)
Using with LiveKit Agents Framework
from livekit.agents import Agent
from livekit.plugins.gladia.stt import STT as GladiaSTT
agent = Agent(
stt=GladiaSTT(
api_key="your-api-key-here",
languages=["en"],
translation_enabled=True,
translation_target_languages=["es"]
)
)
# Rest of your agent setup...
Metadata
Release files for livekit-plugins-gladia 1.8.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| livekit_plugins_gladia-1.8.4.tar.gz | 14.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| livekit_plugins_gladia-1.8.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 30.3 kB
Release files / livekit_plugins_gladia-1.8.4.tar.gz
| Download URL | livekit_plugins_gladia-1.8.4.tar.gz |
|---|---|
| Size | 14.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1316be586170c7786b6e40596ed0c3e396cf420872ac4a66490f07402443c013
|
|
BLAKE2b-256 checksum How to use checksums |
8aa3d067f8cb9f77f48040421160932003e9d5bdfa14d47893193513346b316e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 1, 2026.
Transparency logRelease files / livekit_plugins_gladia-1.8.4-py3-none-any.whl
| Download URL | livekit_plugins_gladia-1.8.4-py3-none-any.whl |
|---|---|
| Size | 15.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ca6c126c3afb534fc02bcc3007f8eb3c583380c1ba2ddf75a35b2ac0decb9086
|
|
BLAKE2b-256 checksum How to use checksums |
fc266103643c5dfdcb88f1b6332d84bd9fd8fa1f78fc7cdc799dfc3f5d490cfd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 1, 2026.
Transparency log
