Google Gemini LLM plugin guide

Overview

This plugin allows you to use Google Gemini as an LLM provider for your voice agents.

Quick reference

This section includes a basic usage example and some reference material. For links to more detailed documentation, see Additional resources.

Installation

Install the plugin from PyPI:

uv add "livekit-agents[google]~=1.3"

pnpm add @livekit/agents-plugin-google@1.x

Authentication

The Google plugin requires authentication based on your chosen service:

• For Vertex AI, you must set the GOOGLE_APPLICATION_CREDENTIALS environment variable to the path of the service account key file. For more information about mounting files as secrets when deploying to LiveKit Cloud, see File-mounted secrets .
• For Google Gemini API, set the GOOGLE_API_KEY environment variable.

Usage

Use Gemini within an AgentSession or as a standalone LLM service. For example, you can use this LLM in the Voice AI quickstart.

from livekit.plugins import google

session = AgentSession(
    llm=google.LLM(
        model="gemini-3-flash-preview",
    ),
    # ... tts, stt, vad, turn_detection, etc.
)

import * as google from '@livekit/agents-plugin-google';

const session = new voice.AgentSession({
    llm: google.LLM(
        model: "gemini-3-flash-preview",
    ),
    // ... tts, stt, vad, turn_detection, etc.
});

Parameters

This section describes some of the available parameters. For a complete reference of all available parameters, see the plugin reference.

Provider tools

Google Gemini supports provider tools that enable the model to use built-in capabilities executed on the model server. These tools can be used alongside function tools defined in your agent's codebase.

Available tools include:

• GoogleSearch: Perform keyword search, semantic search, user search, and thread fetch on Google
• GoogleMaps: Perform search for places and businesses using Google Maps
• URLContext: Provide context for URLs
• ToolCodeExecution: Execute code snippets

from livekit.plugins import google
from google.genai import types

agent = MyAgent(
    llm=google.LLM(
        model="gemini-2.5-flash",
    ),
    tools=[google.tools.GoogleSearch()],
)

import * as google from '@livekit/agents-plugin-google';

// currently, Agents JS supports provider tools via `geminiTools` parameter.

const agent = new MyAgent({
    llm: google.LLM(
        model: "gemini-2.5-flash",
        geminiTools: [new google.types.GoogleSearch()],
    ),
    // ... tts, stt, vad, turn_detection, etc.
});

Additional resources

The following resources provide more information about using Google Gemini with LiveKit Agents.

Python plugin

ReferenceGitHubPyPI

Node.js plugin

ReferenceGitHubNPM

Gemini docs

Google Gemini documentation.

Voice AI quickstart

Get started with LiveKit Agents and Google Gemini.

Google AI ecosystem guide

Overview of the entire Google AI and LiveKit Agents integration.