deep-research

• Python 3.8+
• httpx: pip install -r requirements.txt
• GEMINI_API_KEY environment variable

1. Get a Gemini API key from [Google AI Studio](https://aistudio.google.com/)
2. Set the environment variable:

```bash

export GEMINI_API_KEY=your-api-key-here

```

Or create a .env file in the skill directory.

Start a research task

```bash

python3 scripts/research.py --query "Research the history of Kubernetes"

```

With structured output format

```bash

python3 scripts/research.py --query "Compare Python web frameworks" \

--format "1. Executive Summary\n2. Comparison Table\n3. Recommendations"

```

Stream progress in real-time

```bash

python3 scripts/research.py --query "Analyze EV battery market" --stream

```

Start without waiting

```bash

python3 scripts/research.py --query "Research topic" --no-wait

```

Check status of running research

```bash

python3 scripts/research.py --status

```

Wait for completion

```bash

python3 scripts/research.py --wait

```

Continue from previous research

```bash

python3 scripts/research.py --query "Elaborate on point 2" --continue

```

List recent research

```bash

python3 scripts/research.py --list

```

• Default: Human-readable markdown report
• JSON (--json): Structured data for programmatic use
• Raw (--raw): Unprocessed API response

| Metric | Value |

|--------|-------|

| Time | 2-10 minutes per task |

| Cost | $2-5 per task (varies by complexity) |

| Token usage | ~250k-900k input, ~60k-80k output |

• Market analysis and competitive landscaping
• Technical literature reviews
• Due diligence research
• Historical research and timelines
• Comparative analysis (frameworks, products, technologies)

1. User requests research → Run --query "..."
2. Inform user of estimated time (2-10 minutes)
3. Monitor with --stream or poll with --status
4. Return formatted results
5. Use --continue for follow-up questions

• 0: Success
• 1: Error (API error, config issue, timeout)
• 130: Cancelled by user (Ctrl+C)