https://github.com/ben-vargas/ai-sdk-provider-gemini-cli
Vercel AI SDK community provider for Gemini CLI - Free use via Gemini Code Assist License
https://github.com/ben-vargas/ai-sdk-provider-gemini-cli
ai ai-sdk gemini gemini-cli google-cloud typescript vercel-ai-sdk
Last synced: 5 months ago
JSON representation
Vercel AI SDK community provider for Gemini CLI - Free use via Gemini Code Assist License
- Host: GitHub
- URL: https://github.com/ben-vargas/ai-sdk-provider-gemini-cli
- Owner: ben-vargas
- License: mit
- Created: 2025-06-25T23:41:33.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-10-01T20:25:21.000Z (8 months ago)
- Last Synced: 2025-10-01T20:38:16.099Z (8 months ago)
- Topics: ai, ai-sdk, gemini, gemini-cli, google-cloud, typescript, vercel-ai-sdk
- Language: TypeScript
- Homepage:
- Size: 369 KB
- Stars: 31
- Watchers: 1
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-gemini-cli - Gemini CLI Vercel AI SDK Provider - Seamless Vercel AI SDK integration that unlocks Gemini's capabilities in Next.js and React applications with minimal configuration. (SDKs)
README
# AI SDK Provider for Gemini CLI
A community provider for the [Vercel AI SDK](https://sdk.vercel.ai/docs) that enables using Google's Gemini models through [@google/gemini-cli-core](https://www.npmjs.com/package/@google/gemini-cli-core) and Google Cloud Code endpoints.
## Version Compatibility
| Provider Version | AI SDK Version | NPM Tag | Branch |
| ---------------- | -------------- | ----------- | ----------- |
| 2.x | v6 | `latest` | `main` |
| 1.x | v5 | `ai-sdk-v5` | `ai-sdk-v5` |
| 0.x | v4 | `ai-sdk-v4` | `ai-sdk-v4` |
```bash
# AI SDK v6 (default)
npm install ai-sdk-provider-gemini-cli ai
# AI SDK v5
npm install ai-sdk-provider-gemini-cli@ai-sdk-v5 ai@^5.0.0
# AI SDK v4
npm install ai-sdk-provider-gemini-cli@ai-sdk-v4 ai@^4.3.16
```
## Installation
1. Install and authenticate the Gemini CLI:
```bash
npm install -g @google/gemini-cli
gemini # Follow the interactive authentication setup
```
2. Add the provider to your project:
```bash
npm install ai-sdk-provider-gemini-cli ai
```
## Quick Start
```typescript
import { generateText } from 'ai';
import { createGeminiProvider } from 'ai-sdk-provider-gemini-cli';
const gemini = createGeminiProvider({
authType: 'oauth-personal',
});
const result = await generateText({
model: gemini('gemini-3-pro-preview'),
prompt: 'Write a haiku about coding',
});
console.log(result.text);
```
## Authentication
### OAuth (Recommended)
Uses credentials from `~/.gemini/oauth_creds.json` created by the Gemini CLI:
```typescript
const gemini = createGeminiProvider({
authType: 'oauth-personal',
});
```
### API Key
```typescript
const gemini = createGeminiProvider({
authType: 'api-key',
apiKey: process.env.GEMINI_API_KEY,
});
```
Get your API key from [Google AI Studio](https://aistudio.google.com/apikey).
## Supported Models
- `gemini-3-pro-preview` - Latest model with enhanced reasoning (Preview)
- `gemini-3-flash-preview` - Fast, efficient model (Preview)
- `gemini-2.5-pro` - Previous generation model (64K output tokens)
- `gemini-2.5-flash` - Previous generation fast model (64K output tokens)
## Features
- Streaming responses
- Tool/function calling
- Structured output with Zod schemas
- Multimodal support (text and base64 images)
- TypeScript support
- Configurable logging
## Configuration
```typescript
const model = gemini('gemini-3-pro-preview', {
temperature: 0.7,
maxOutputTokens: 1000,
topP: 0.95,
});
```
### Logging
```typescript
// Disable logging
const model = gemini('gemini-3-flash-preview', { logger: false });
// Enable verbose debug logging
const model = gemini('gemini-3-flash-preview', { verbose: true });
// Custom logger
const model = gemini('gemini-3-flash-preview', {
logger: {
debug: (msg) => myLogger.debug(msg),
info: (msg) => myLogger.info(msg),
warn: (msg) => myLogger.warn(msg),
error: (msg) => myLogger.error(msg),
},
});
```
## Examples
See the [examples/](examples/) directory for comprehensive examples:
- `check-auth.mjs` - Verify authentication
- `basic-usage.mjs` - Text generation
- `streaming.mjs` - Streaming responses
- `generate-object-basic.mjs` - Structured output with Zod
- `tool-calling.mjs` - Function calling
```bash
npm run build
npm run example:check
npm run example:basic
```
## Breaking Changes
### v2.x (AI SDK v6)
- Provider interface: ProviderV2 → ProviderV3
- Token usage: flat → hierarchical structure
- Warning format: `unsupported-setting` → `unsupported`
- Method rename: `textEmbeddingModel()` → `embeddingModel()`
- Finish reason: string → `{ unified, raw }` object
See [CHANGELOG.md](CHANGELOG.md) for details.
## Limitations
- Requires Node.js >= 20
- OAuth requires global Gemini CLI installation
- Image URLs not supported (use base64)
- Some parameters not supported: `frequencyPenalty`, `presencePenalty`, `seed`
- Abort signals work but underlying requests continue in background
## Disclaimer
This is an unofficial community provider, not affiliated with Google or Vercel. Your data is sent to Google's servers. See [Google's Terms of Service](https://policies.google.com/terms).
## License
MIT