Google Gemini plugin for LiveKit Node Agents
npm install @livekit/agents-plugin-googleThis plugin provides Google Gemini LLM support for LiveKit Node Agents using the new unified @google/genai SDK.
``bash`
npm install @livekit/agents-plugin-google
`typescript
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 (Beta)
`typescript
import * as google from '@livekit/agents-plugin-google';
const realtimeModel = new google.beta.realtime.RealtimeModel()
const geminiTTS = new google.beta.TTS(),
`
- GOOGLE_API_KEY or GOOGLE_GENAI_API_KEY: Your Google AI Studio API keyGOOGLE_GENAI_USE_VERTEXAI
- : Set to true or 1 to enable Vertex AIGOOGLE_CLOUD_PROJECT
- : Your Google Cloud project ID (for Vertex AI)GOOGLE_CLOUD_LOCATION
- : Your preferred location (default: us-central1)
- 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)
`typescript`
const llm = new LLM({
model: 'gemini-1.5-pro',
temperature: 0.7,
maxOutputTokens: 2048,
topP: 0.8,
topK: 40,
toolChoice: 'auto',
});
Set your API key via environment variable or constructor option:
`bash`
export GOOGLE_API_KEY=your-api-key
For Vertex AI, ensure you have:
1. Google Cloud CLI installed and authenticated
2. Vertex AI API enabled in your project
3. Proper authentication configured (Application Default Credentials)
`bash``
gcloud auth application-default login
export GOOGLE_CLOUD_PROJECT=your-project-id
export GOOGLE_GENAI_USE_VERTEXAI=true
Apache 2.0