Introduction
# 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