Skip to main content
Pre-release

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

Google AI plugin for LiveKit Agents

Support for Gemini, Gemini Live, Cloud Speech-to-Text, and Cloud Text-to-Speech.

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

Installation

pip install livekit-plugins-google

Pre-requisites

For credentials, you'll need a Google Cloud account and obtain the correct credentials. Credentials can be passed directly or via Application Default Credentials as specified in How Application Default Credentials works.

To use the STT and TTS API, you'll need to enable the respective services for your Google Cloud project.

  • Cloud Speech-to-Text API
  • Cloud Text-to-Speech API

Speech-to-Text and Text-to-Speech

The plugin has two speech products, each with its own class:

  • google.STT and google.TTS: Cloud Speech-to-Text (V2 API) and Cloud Text-to-Speech, over gRPC with Google Cloud credentials.
  • google.GeminiSTT and google.GeminiTTS: transcription over a Gemini Live session, and speech generation through the Gemini API, with a Gemini API key or Vertex AI. GeminiTTS supports multi-speaker voices and per-sentence delivery styles.

google.STT speaks the Speech-to-Text V2 API only. model takes a V2 model (long, the default, short, telephony, telephony_short, medical_dictation, medical_conversation, chirp, chirp_2, chirp_3, chirp_telephony); V1-only names such as latest_long are not accepted. Recognition needs a Google Cloud project, from project, the credentials, or Application Default Credentials.

google.GeminiTTS defaults to gemini-3.8-flash-tts; gemini-3.8-flash-lite-tts is the faster, cheaper option.

Live API model support

LiveKit supports the Gemini Live API through both the Gemini Developer API and Vertex AI. Model availability and behavior differ between APIs. Some models, such as gemini-3.8-live, are available on both.

For model/API pairs that appear incompatible, the plugin logs a warning and lets the API decide whether the model is available.

The following models are supported by Gemini Developer API:

  • gemini-3.8-live
  • gemini-3.8-live-extended-thinking
  • gemini-3.1-flash-live-preview
  • gemini-2.5-flash-native-audio-preview-09-2025
  • gemini-2.5-flash-native-audio-preview-12-2025

On the Gemini Developer API, gemini-3.8-live does not support thinking_config.thinking_level. Use gemini-3.8-live-extended-thinking for configurable thinking.

And these on Vertex AI:

  • gemini-3.8-live
  • gemini-live-2.5-flash-native-audio

References:

Metadata

Release files for livekit-plugins-google 2.0.0b2

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-google 2.0.0b2
File Size Uploaded Provenance Actions
livekit_plugins_google-2.0.0b2.tar.gz 58.7 kB With provenance Details for livekit_plugins_google-2.0.0b2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for livekit-plugins-google 2.0.0b2
File Interpreter ABI Platform Actions
livekit_plugins_google-2.0.0b2-py3-none-any.whl Python 3 none any Details for livekit_plugins_google-2.0.0b2-py3-none-any.whl

Total release size: 125.6 kB

Release files / livekit_plugins_google-2.0.0b2.tar.gz

Download URL livekit_plugins_google-2.0.0b2.tar.gz
Size 58.7 kB
Tags Source
SHA-256 checksum
How to use checksums
ef2fb73c032e45adb44069ad80ea53af369b3b8e3e0d6bc678cd494b46f9859d
BLAKE2b-256 checksum
How to use checksums
61e9d6bed1a60a232f1be0766f74a454df226cc7d27175ae0cca6c22a6582ae1
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 Nov 18, 2026.

Transparency log

Release files / livekit_plugins_google-2.0.0b2-py3-none-any.whl

Download URL livekit_plugins_google-2.0.0b2-py3-none-any.whl
Size 66.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f3b231791aa11262a9d4bfb10acdb0777dcf527043ffd9a3e338b22d120cd629
BLAKE2b-256 checksum
How to use checksums
8b1085085cbdb4c8da54a9ba54658eb04c83823400092156ddbbe63b4cda0530
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 Nov 18, 2026.

Transparency log

Security for livekit-plugins-google 2.0.0b2

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for livekit_plugins_google-2.0.0b2.tar.gz

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 Nov 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page