> ## Documentation Index
> Fetch the complete documentation index at: https://docs.praison.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Provider

> Use Google Gemini models with PraisonAI TypeScript

# Google Provider

Use Google's Gemini models including Gemini 2.0 Flash and Gemini 1.5 Pro.

## Environment Variables

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
export GOOGLE_GENERATIVE_AI_API_KEY=AIza...
# or
export GOOGLE_API_KEY=AIza...
```

| Variable                       | Required | Description              |
| ------------------------------ | -------- | ------------------------ |
| `GOOGLE_GENERATIVE_AI_API_KEY` | Yes      | Google AI Studio API key |
| `GOOGLE_API_KEY`               | Alt      | Alternative env var name |

## Supported Modalities

| Modality   | Supported |
| ---------- | --------- |
| Text/Chat  | ✅         |
| Embeddings | ✅         |
| Image      | ✅         |
| Audio      | ✅         |
| Speech     | ✅         |
| Tools      | ✅         |

## Quick Start

```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { Agent } from 'praisonai';

const agent = new Agent({
  name: 'Gemini',
  instructions: 'You are a helpful assistant.',
  llm: 'google/gemini-2.0-flash'
});

const response = await agent.chat('Hello!');
console.log(response);
```

## Available Models

| Model                 | Description       | Context |
| --------------------- | ----------------- | ------- |
| `gemini-2.0-flash`    | Latest fast model | 1M      |
| `gemini-1.5-pro`      | Most capable      | 2M      |
| `gemini-1.5-flash`    | Fast, efficient   | 1M      |
| `gemini-1.5-flash-8b` | Lightweight       | 1M      |

## Advanced Configuration

```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { Agent } from 'praisonai';

const agent = new Agent({
  name: 'GeminiPro',
  instructions: 'You are an expert analyst.',
  llm: 'google/gemini-1.5-pro',
  llmConfig: {
    temperature: 0.7,
    maxTokens: 8192,
  }
});
```

## With Tools

```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { Agent } from 'praisonai';

const weatherTool = {
  name: 'get_weather',
  description: 'Get current weather',
  parameters: {
    type: 'object',
    properties: {
      location: { type: 'string', description: 'City name' }
    },
    required: ['location']
  },
  execute: async ({ location }) => {
    return `Weather in ${location}: Sunny, 72°F`;
  }
};

const agent = new Agent({
  name: 'WeatherGemini',
  instructions: 'Help with weather queries.',
  llm: 'google/gemini-2.0-flash',
  tools: [weatherTool]
});
```

## Vision (Image Input)

```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { Agent } from 'praisonai';

const agent = new Agent({
  name: 'VisionGemini',
  instructions: 'Analyze images.',
  llm: 'google/gemini-1.5-pro'
});

const response = await agent.chat({
  content: 'Describe this image',
  images: ['https://example.com/image.jpg']
});
```

## Streaming

```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { Agent } from 'praisonai';

const agent = new Agent({
  name: 'StreamGemini',
  instructions: 'You are helpful.',
  llm: 'google/gemini-2.0-flash'
});

for await (const chunk of agent.stream('Tell me a story')) {
  process.stdout.write(chunk);
}
```

## Troubleshooting

### Invalid API Key

```
Error: Google Generative AI API key is missing
```

**Solution**: Set the correct environment variable:

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
export GOOGLE_GENERATIVE_AI_API_KEY=AIza...
```

### Rate Limits

```
Error: Resource exhausted
```

**Solution**: Implement retry logic or upgrade your Google AI plan.

## Related

* [Google CLI Usage](/docs/js/providers/google-cli)
* [Google Vertex AI](/docs/js/providers/google-vertex-code)
* [Providers Overview](/docs/js/providers)