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...

Release files for livekit-plugins-gladia 1.8.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for livekit-plugins-gladia 1.8.1
File	Size	Uploaded
livekit_plugins_gladia-1.8.1.tar.gz	14.8 kB	Sep 10, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for livekit-plugins-gladia 1.8.1
File	Interpreter	ABI	Platform	Reset
livekit_plugins_gladia-1.8.1-py3-none-any.whl 15.5 kB Sep 10, 2026	Python 3	none	any	Details

Total release size: 30.3 kB

Release files / livekit_plugins_gladia-1.8.1.tar.gz

Download URL	livekit_plugins_gladia-1.8.1.tar.gz
Size	14.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`0132fcde6efe6f74f1f0baf7031e193798b989d55405abb617b29349c4571627`
BLAKE2b-256 checksum How to use checksums	`d1922804bb6bb5dc78eec92b3809cc96cef825c5f0f18fae0802df6fa87c44ec`
Upload date	Sep 10, 2026
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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/livekit/agents
Publishing commit: github.com/livekit/agents/tree/f9b53c3c22e15a265d454c1e54dbc07ed3a50396

Workflow

Publishing configuration: github.com/livekit/agents/blob/f9b53c3c22e15a265d454c1e54dbc07ed3a50396/.github/workflows/publish.yml
Publishing logs: github.com/livekit/agents/actions/runs/34517494853/attempts/1

Artifact

Subject: livekit_plugins_gladia-1.8.1.tar.gz
SHA-256 checksum: 0132fcde6efe6f74f1f0baf7031e193798b989d55405abb617b29349c4571627 Verifying attestations

Release files / livekit_plugins_gladia-1.8.1-py3-none-any.whl

Download URL	livekit_plugins_gladia-1.8.1-py3-none-any.whl
Size	15.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`5a9b3189a592f6847b21508dbe50377185aa555357bf624cf13202dd3b1bfe4e`
BLAKE2b-256 checksum How to use checksums	`8756400a2c00cf26dea8599f1cf98b384934fdda3d157cdfaf33467506e7c43a`
Upload date	Sep 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/livekit/agents
Publishing commit: github.com/livekit/agents/tree/f9b53c3c22e15a265d454c1e54dbc07ed3a50396

Workflow

Publishing configuration: github.com/livekit/agents/blob/f9b53c3c22e15a265d454c1e54dbc07ed3a50396/.github/workflows/publish.yml
Publishing logs: github.com/livekit/agents/actions/runs/34517494853/attempts/1

Artifact

Subject: livekit_plugins_gladia-1.8.1-py3-none-any.whl
SHA-256 checksum: 5a9b3189a592f6847b21508dbe50377185aa555357bf624cf13202dd3b1bfe4e Verifying attestations