gemini-deep-research

# Gemini Deep Research Use Gemini's Deep Research Agent to perform complex, long-running context gathering and synthesis tasks. ## 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 Deep Research is an agent that: 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 ```bash scripts/deep_research.py --query "Research the history of Google TPUs" ``` ### Custom Output Format ```bash 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) ```bash 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 ```bash scripts/deep_research.py --query "Your research topic" --stream ``` ## Output The script saves results to timestamped files: - `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](https://aistudio.google.com/apikey)) - Does NOT work with Antigravity OAuth authentication - Long-running tasks (minutes to hours depending on complexity) - May incur API costs depending on your quota