Gemini Provider

Docs home · Provider guide · Configuration · DeepSeek · OpenAI-compatible · Anthropic · 简体中文

Use the Gemini provider when you want Sigil to call Gemini models through Google's streamGenerateContent API.

Minimal Setup

For temporary local use:

export SIGIL_GEMINI_API_KEY="..."
sigil

For reusable config:

[agent]
provider = "gemini"
model = "gemini-2.5-pro"
tool_timeout_secs = 30

[model_request]
request_timeout_secs = 120
stream_idle_timeout_secs = 180

[providers.gemini]
base_url = "https://generativelanguage.googleapis.com/v1beta"
# Prefer SIGIL_GEMINI_API_KEY.
# api_key = "..."

A full starting template is available at gemini.toml.

Authentication

Sigil resolves Gemini authentication in this order:

1. SIGIL_GEMINI_API_KEY
2. [providers.gemini].api_key

Prefer SIGIL_GEMINI_API_KEY when you want Sigil-specific credentials without affecting other Google tooling in the same shell.

Environment Overrides

Behavior Notes

Sigil handles Gemini's request format, function calling, responses, usage, and safety blocks for you. Gemini-specific options remain on this page, while the normal tool-approval, privacy, and session workflow stays the same.

Image attachments are available only for explicitly recognized Gemini model IDs. Floating latest names, unknown IDs, and unrecognized aliases fail before provider transport. See Image Attachments for input methods, local limits, cache behavior, and resume guidance.

Gemini model names and endpoint availability can vary by account and region. Keep [agent].model explicit when using this provider in automation.

Verify

Run:

sigil doctor

Check provider name, model, base URL and API key source.

Common Problems