Google Gemini

The Gemini provider lives in crates/lime-provider-gemini/ and uses Google’s Generative Language API (streamGenerateContent over SSE).

Authentication

lime login --provider gemini --with-api-key

Or via environment:

export GEMINI_API_KEY="AIza…"
# or, as a fallback Lime also reads:
export GOOGLE_API_KEY="AIza…"

GEMINI_API_KEY takes priority when both are set.

Built-in catalog

Slug	Display	Context	Capabilities
`gemini-2.5-pro`	Gemini 2.5 Pro	1M	Vision, parallel tools, dynamic thinking, `param_preset: reasoning_only`
`gemini-2.5-flash`	Gemini 2.5 Flash	1M	Vision, parallel tools, dynamic thinking, `param_preset: reasoning_only`
`gemini-2.5-flash-lite`	Gemini 2.5 Flash-Lite	1M	Vision, parallel tools, thinking opt-in, `param_preset: reasoning_only`
`gemini-3.1-pro-preview`	Gemini 3.1 Pro (preview)	1M	Vision, parallel tools, `param_preset: reasoning_only`
`gemini-3-flash-preview`	Gemini 3 Flash (preview)	1M	Vision, parallel tools, `param_preset: reasoning_only`
`gemini-3.1-flash-lite-preview`	Gemini 3.1 Flash-Lite (preview)	1M	Vision, parallel tools, `param_preset: reasoning_only`

Aliases

Friendly aliases resolve to canonical slugs:

Alias	Resolves to
`pro`, `gemini-pro`	`gemini-2.5-pro`
`flash`, `gemini-flash`	`gemini-2.5-flash`
`flash-lite`, `gemini-flash-lite`	`gemini-2.5-flash-lite`
`pro-3`, `gemini-3-pro`, `gemini-3.1-pro`	`gemini-3.1-pro-preview`
`flash-3`, `gemini-3-flash`	`gemini-3-flash-preview`
`flash-lite-3`, `gemini-3.1-flash-lite`	`gemini-3.1-flash-lite-preview`

Any full wire id is accepted as-is, so date-stamped previews like gemini-2.5-pro-preview-03-25 work without registering a custom slug.

What’s special

Streaming via SSE. The provider speaks Google’s streamGenerateContent SSE format end-to-end.
Thinking. On Gemini 2.5+ models, the thinking_config field is populated automatically when the catalog declares thinking support. Earlier models silently ignore the field. Thinking state lives on the server; it is not round-tripped through the session log.
--reasoning-effort maps onto Google’s thinking budget when applicable; otherwise it is ignored.

Common usage

The provider is inferred from the model slug — pass --model and Lime routes to the Gemini provider automatically:

lime --model pro
lime --model gemini-2.5-flash
lime --model gemini-2.5-pro-preview-03-25

--provider gemini is only accepted inside lime login, lime logout, and lime model add — not at the top level. For a custom slug that should resolve to Gemini, register it with lime model add --provider gemini.