Pre-release

This release is a pre-release and may not be stable for production use.

Speechmatics STT plugin for LiveKit Agents

Support for Speechmatics STT.

See https://docs.livekit.io/agents/integrations/stt/speechmatics/ for more information.

Installation

pip install livekit-plugins-speechmatics

Diarization

Speechmatics STT engine can be configured to emit information about individual speakers in a conversation. This needs to be enabled using enable_diarization=True. The text output of the transcription can be configured to include this information using the macros speaker_id and text, as shown in the examples below.

  • <{speaker_id}>{text}</{speaker_id}> -> <S1>Hello</S1>
  • [Speaker {speaker_id}] {text} -> [Speaker S1] Hello

You should adjust your system instructions to inform the LLM of this format for speaker identification.

Turn detection modes

The turn_detection_mode parameter controls how end-of-turn is detected:

  • EXTERNAL (default) — Speechmatics does not endpoint on its own; turn boundaries are driven by an external VAD or by calling finalize(). If no vad is passed, Silero is auto-loaded (requires livekit-plugins-silero). Pass vad=None to opt out and drive finalize() yourself.
  • ADAPTIVE — Speechmatics controls end of turn using its own VAD and the pace of speech.
  • SMART_TURN — Speechmatics ML-based endpointing.
  • FIXED — Endpoints after a fixed silence duration set by end_of_utterance_silence_trigger.

Usage (LiveKit Turn Detection)

The default EXTERNAL mode pairs naturally with LiveKit's turn detector. The format for the output text needs to be adjusted to not include any extra content at the end of the utterance. Using [Speaker S1] ... as the speaker_active_format should work well. You may need to adjust your system instructions to inform the LLM of this format for speaker identification. You must also include the listener for when the VAD has detected the end of speech.

The end_of_utterance_silence_trigger parameter controls the amount of silence before the end of turn detection is triggered. The default is 0.5 seconds.

Usage:

from livekit.agents import AgentSession, inference
from livekit.agents.inference import TurnDetector
from livekit.plugins import speechmatics

agent = AgentSession(
    stt=speechmatics.STT(
        end_of_utterance_silence_trigger=0.2,
        speaker_active_format="[Speaker {speaker_id}] {text}",
        speaker_passive_format="[Speaker {speaker_id} *PASSIVE*] {text}",
    ),
    vad=inference.VAD(),
    turn_detection=TurnDetector(),
    min_endpointing_delay=0.3,
    max_endpointing_delay=5.0,
    ...
)

Usage (Speechmatics end of utterance detection and speaker ID)

To delegate end-of-turn detection to Speechmatics, set turn_detection_mode=TurnDetectionMode.ADAPTIVE (or SMART_TURN / FIXED) and pair it with turn_detection="stt" on the AgentSession.

from livekit.agents import AgentSession
from livekit.plugins import speechmatics

agent = AgentSession(
    stt=speechmatics.STT(
        turn_detection_mode=speechmatics.TurnDetectionMode.ADAPTIVE,
        speaker_active_format="[Speaker {speaker_id}] {text}",
        speaker_passive_format="[Speaker {speaker_id} *PASSIVE*] {text}",
        additional_vocab=[
            speechmatics.AdditionalVocabEntry(
                content="LiveKit",
                sounds_like=["live kit"],
            ),
        ],
    ),
    turn_detection="stt",
    ...
)

Pre-requisites

You'll need to specify a Speechmatics API Key. It can be set as environment variable SPEECHMATICS_API_KEY or .env.local file.

Project links

Data verified by PyPI on Aug 13, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Stable release available (1.6.10)

Owner

PyPI data
Data sourced directly from PyPI's database.

Credits

Author: LiveKit

GitHub Statistics

Data verified by PyPI on Aug 13, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python >=3.10.0

Tags

ai audio livekit realtime speechmatics video voice

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

livekit_plugins_speechmatics-1.6.11rc1.tar.gz (15.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

livekit_plugins_speechmatics-1.6.11rc1-py3-none-any.whl (17.0 kB view details)

Uploaded Python 3

File details

Details for the file livekit_plugins_speechmatics-1.6.11rc1.tar.gz.

File metadata

File hashes

Hashes for livekit_plugins_speechmatics-1.6.11rc1.tar.gz
Algorithm Hash digest
SHA256 71df768e65c5a35da88caf3209832395aab6cb653051157d47744b3d62977395
MD5 55fc9f572fbef9b8d2d038832b685ddd
BLAKE2b-256 0016118ae5220ccbc416642fb9686782620545db209998caeab5bbf9abfc461e

See more details on using hashes here.

Provenance

The following attestation bundles were made for livekit_plugins_speechmatics-1.6.11rc1.tar.gz:

Publisher: publish.yml on livekit/agents

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file livekit_plugins_speechmatics-1.6.11rc1-py3-none-any.whl.

File metadata

File hashes

Hashes for livekit_plugins_speechmatics-1.6.11rc1-py3-none-any.whl
Algorithm Hash digest
SHA256 57a78f8e3f1ea3d8b1ba9f9cf704656292d7d9d5f5df8e9fb4d8b00ab9b915bb
MD5 7414e7eb14ca8b97ae54b7ead9a549ac
BLAKE2b-256 68fdfa092867ce18a94e1ee1b869ab1866c9d75f6ef550718513d81b4cf14f68

See more details on using hashes here.

Provenance

The following attestation bundles were made for livekit_plugins_speechmatics-1.6.11rc1-py3-none-any.whl:

Publisher: publish.yml on livekit/agents

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

1.6.11rc1 pre-release

1.6.10

1.6.9

1.6.8

1.6.7

1.6.6

1.6.5

1.6.4

1.6.3

1.6.2

1.6.1

1.6.0

1.6.0rc2 pre-release

1.6.0rc1 pre-release

1.5.19rc1 pre-release

1.5.18

1.5.17

1.5.16

1.5.15

1.5.14

1.5.13

1.5.12

1.5.11

1.5.10

1.5.9

1.5.8

1.5.7

1.5.6

1.5.5

1.5.4

1.5.3

1.5.2

1.5.1

1.5.0

1.5.0rc2 pre-release

1.5.0rc1 pre-release

1.4.6

1.4.5

1.4.4

1.4.3

1.4.2

1.4.1

1.4.0rc2 pre-release

1.4.0rc1 pre-release

1.3.12

1.3.11

1.3.10

1.3.9

1.3.8

1.3.7

1.3.6

1.3.5

1.3.4

1.3.3

1.3.2

1.3.1

1.3.0rc2 pre-release

1.3.0rc1 pre-release

1.2.18

1.2.17

1.2.16

1.2.15

1.2.14

1.2.13

1.2.12

1.2.11

1.2.9

1.2.8

1.2.7

1.2.6

1.2.5

1.2.4

1.2.3

1.2.2

1.2.1

1.2.0

1.1.7

1.1.6

1.1.5

1.1.4

1.1.3

1.1.2

1.1.1

1.1.0

1.0.23

1.0.22

1.0.21

1.0.20

1.0.19

1.0.18

1.0.17

1.0.16

1.0.15

1.0.14

1.0.13

1.0.12

1.0.11

1.0.0rc9 pre-release

1.0.0rc8 pre-release

1.0.0rc7 pre-release

1.0.0rc6 pre-release

1.0.0rc5 pre-release

1.0.0rc4 pre-release

1.0.0rc3 pre-release

1.0.0rc2 pre-release

1.0.0rc1 pre-release

1.0.0.dev5 pre-release

1.0.0.dev4 pre-release

0.0.3

0.0.2

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page