Gemini Deep Research

Prerequisites

• GEMINI_API_KEY

  environment variable (from Google AI Studio)
• Note: This does NOT work with Antigravity OAuth tokens. Requires a direct Gemini API key.

How It Works

1. Breaks down complex queries into sub-questions
2. Searches the web systematically
3. Synthesizes findings into comprehensive reports
4. Provides streaming progress updates

Usage

Basic Research

scripts/deep_research.py --query "Research the history of Google TPUs"

Custom Output Format

scripts/deep_research.py --query "Research the competitive landscape of EV batteries" \
  --format "1. Executive Summary\n2. Key Players (include data table)\n3. Supply Chain Risks"

With File Search (optional)

scripts/deep_research.py --query "Compare our 2025 fiscal year report against current public web news" \
  --file-search-store "fileSearchStores/my-store-name"

Stream Progress

scripts/deep_research.py --query "Your research topic" --stream

Output

• deep-research-YYYY-MM-DD-HH-MM-SS.md

  - Final report in markdown

• deep-research-YYYY-MM-DD-HH-MM-SS.json

  - Full interaction metadata

API Details

• Endpoint:

  https://generativelanguage.googleapis.com/v1beta/interactions

• Agent:

  deep-research-pro-preview-12-2025

• Auth:

  x-goog-api-key

  header (NOT OAuth Bearer token)

Limitations

• Requires Gemini API key (get from Google AI Studio)
• Does NOT work with Antigravity OAuth authentication
• Long-running tasks (minutes to hours depending on complexity)
• May incur API costs depending on your quota