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

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.2
File	Size	Uploaded
livekit_plugins_gladia-1.8.2.tar.gz	14.8 kB	Sep 15, 2026	Details

Built distribution (wheel)

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

Total release size: 30.3 kB

Release files / livekit_plugins_gladia-1.8.2.tar.gz

Download URL	livekit_plugins_gladia-1.8.2.tar.gz
Size	14.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`2d00ad397dabecfd08c0c2f7e914f510bdfd7adc385af5438986fbc9b19c2c78`
BLAKE2b-256 checksum How to use checksums	`ec35ca3af44b13ca8b3c967fdb98145f3234db5e2848e5c85110142db0baa850`
Upload date	Sep 15, 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/bb8c72255c40fdfd689248e0632825af7e2d7b32

Workflow

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

Artifact

Subject: livekit_plugins_gladia-1.8.2.tar.gz
SHA-256 checksum: 2d00ad397dabecfd08c0c2f7e914f510bdfd7adc385af5438986fbc9b19c2c78 Verifying attestations

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

Download URL	livekit_plugins_gladia-1.8.2-py3-none-any.whl
Size	15.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`5e504eea681c8d5151fa2700bf507e12329c207d9987ddb05fd922e7b5cc5e3c`
BLAKE2b-256 checksum How to use checksums	`3764185cbe3e4364fdfd04c7d0e331b28b2fd77e03c44364387ca3bda18c3b7c`
Upload date	Sep 15, 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/bb8c72255c40fdfd689248e0632825af7e2d7b32

Workflow

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

Artifact

Subject: livekit_plugins_gladia-1.8.2-py3-none-any.whl
SHA-256 checksum: 5e504eea681c8d5151fa2700bf507e12329c207d9987ddb05fd922e7b5cc5e3c Verifying attestations