🔬 AI Research Planner & Executor Agent with Google's Interactions API

A streamlined multi-phase research agent built with Google's Interactions API that demonstrates stateful conversations, model mixing, background execution, and automatic infographic generation.

🌟 Features

• 📋 Phase 1 - Research Planning: Uses Gemini 3 Flash to create structured, actionable research plans
• 🔍 Phase 2 - Task Selection & Deep Research: Select specific tasks and leverage Deep Research Agent with built-in web search
• 📊 Phase 3 - Synthesis + TL;DR: Uses Gemini 3 Pro for executive reports + Gemini 3 Pro Image for automatic infographic generation
• 🎨 Auto-Generated Infographics: Creates whiteboard-style TL;DR summary at the top of every report
• 🔄 Stateful Conversations: Demonstrates previous_interaction_id for maintaining context across phases
• ⚡ Background Execution: Async research execution with progress tracking
• 📥 Export Reports: Download comprehensive research reports as markdown files

🎯 How It Works

User Goal
    ↓
[Phase 1] Gemini 3 Flash → Research Plan
    ↓
[Phase 2] Select Tasks → Deep Research Agent → Research Results
    ↓
[Phase 3] Gemini 3 Pro → Executive Report
         + Gemini 3 Pro Image → TL;DR Infographic

Phase 1: Planning

1. Enter your research goal
2. Gemini 3 Flash creates a numbered research plan with 5-8 specific tasks
3. Plan is stored as an Interaction for stateful continuation

Phase 2: Select & Research

1. Review the research plan with checkboxes for each task
2. Select/deselect tasks to focus your research
3. Deep Research Agent executes comprehensive web research using previous_interaction_id

Phase 3: Synthesis + Infographic

1. Gemini 3 Pro synthesizes findings into an executive report
2. Gemini 3 Pro Image automatically generates a whiteboard TL;DR infographic
3. Report displays with infographic at the top, followed by full text
4. Download as markdown

🛠️ Tech Stack

Component	Technology
Planning Model	gemini-3-flash-preview
Research Agent	deep-research-pro-preview-12-2025
Synthesis Model	gemini-3-pro-preview
Infographic Model	gemini-3-pro-image-preview
UI Framework	Streamlit
Python SDK	google-genai

How to get Started?

1. Clone the GitHub repository

git clone https://github.com/Shubhamsaboo/awesome-llm-apps.git
cd advanced_ai_agents/single_agent_apps/research_agent_gemini_interaction_api

2. Install the required dependencies:

pip install -r requirements.txt

3. Get your Google API Key

• Sign up for a Google AI Studio account and obtain your API key.

4. Run the Streamlit App

streamlit run research_planner_executor_agent.py

5. Open your browser at http://localhost:8501

6. Enter your Google API key in the sidebar and start researching!

📝 Example Research Goals

• "Research the B2B HR SaaS market in Germany - key players, regulations, pricing models"
• "Analyze market opportunities for AI-powered customer support tools"
• "Investigate the competitive landscape for sustainable packaging in e-commerce"
• "Research regulatory requirements for fintech products targeting Gen Z"

⚠️ Notes

• Beta API: The Interactions API is in Beta - features may change
• Deep Research: May take 2-5 minutes for comprehensive research
• Agent vs Model: Deep Research uses agent parameter, not model
• Image Generation: Infographic generation uses the standard generate_content API

🔗 Resources

• Gemini Interactions API Docs
• Gemini Models
• Google AI Studio

📄 License

Part of the Awesome LLM Apps collection.