@livekit/agents-plugin-google
v1.10.1
Published
Google Gemini plugin for LiveKit Node Agents
Maintainers
Keywords
Readme
LiveKit Agents Google Plugin
This plugin provides Google Gemini LLM support for LiveKit Node Agents using the new unified @google/genai SDK.
Installation
npm install @livekit/agents-plugin-googleUsage
Basic Setup
import { LLM } from '@livekit/agents-plugin-google';
// Using Google AI Studio (API Key)
const llm = new LLM({
model: 'gemini-1.5-flash',
apiKey: 'your-api-key', // or set GOOGLE_API_KEY env var
});
// Using Vertex AI
const llm = new LLM({
model: 'gemini-1.5-pro',
vertexai: true,
project: 'your-project-id', // or set GOOGLE_CLOUD_PROJECT env var
location: 'us-central1', // or set GOOGLE_CLOUD_LOCATION env var
});To use the Gemini realtime model or TTS (TTS is Beta)
import * as google from '@livekit/agents-plugin-google';
const realtimeModel = new google.realtime.RealtimeModel({
model: 'gemini-2.5-flash-native-audio-preview-12-2025',
})
const geminiTTS = new google.beta.TTS(),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.
On the Gemini Developer API, gemini-3.8-live does not support thinkingConfig.thinkingLevel. Use gemini-3.8-live-extended-thinking for configurable thinking.
References:
Environment Variables
GOOGLE_API_KEYorGOOGLE_GENAI_API_KEY: Your Google AI Studio API keyGOOGLE_GENAI_USE_VERTEXAI: Set totrueor1to enable Vertex AIGOOGLE_CLOUD_PROJECT: Your Google Cloud project ID (for Vertex AI)GOOGLE_CLOUD_LOCATION: Your preferred location (default:us-central1)
Supported Models
gemini-1.5-pro- Most capable modelgemini-1.5-flash- Fast and efficientgemini-1.5-flash-8b- Ultra-fast lightweight modelgemini-2.0-flash-exp- Latest experimental model- And more (see models.ts for full list)
Thinking Configuration
thinkingConfigis model-specific.- Gemini 3.1 live models use
thinkingLevelsuch asminimal,low,medium, andhigh. - Gemini 2.5 live models use
thinkingBudget.
Advanced Configuration
const llm = new LLM({
model: 'gemini-1.5-pro',
temperature: 0.7,
maxOutputTokens: 2048,
topP: 0.8,
topK: 40,
toolChoice: 'auto',
});Authentication
Google AI Studio
Set your API key via environment variable or constructor option:
export GOOGLE_API_KEY=your-api-keyVertex AI
For Vertex AI, ensure you have:
- Google Cloud CLI installed and authenticated
- Vertex AI API enabled in your project
- Proper authentication configured (Application Default Credentials)
gcloud auth application-default login
export GOOGLE_CLOUD_PROJECT=your-project-id
export GOOGLE_GENAI_USE_VERTEXAI=trueLicense
Apache 2.0
