Research Agent

AI-powered research assistant CLI using Google Gemini with multi-agent workflow for comprehensive research and report generation.

✨ Features

• 🤖 Multi-Agent Research - ResearchAgent, WriteAgent, and ReviewAgent workflow
• 🔍 Web Search Integration - Google Search API for comprehensive research
• 📄 Report Generation - Automated report writing and review process
• ⚙️ Flexible Configuration - Environment variables and config files
• 📊 Rich Terminal Output - Beautiful CLI interface with progress display
• 🔧 Production Ready - Error handling, logging, and robust architecture

🚀 Quick Start

Installation

uv pip install -e .

Usage

# Set your Google Gemini API key
export GEMINI_API_KEY="your-api-key-here"

# Run research
research-agent search "What is the capital of France?"

# Save results to file
research-agent search "History of AI" --output report.md

# Show configuration
research-agent config --show

🛠️ Development

# Install development dependencies
uv pip install -e ".[dev]"

# Run tests
pytest

# Format code
black .
isort .

⚙️ Configuration

Required Environment Variable

export GEMINI_API_KEY="your-gemini-api-key-here"

Optional Configuration

# Set default model
research-agent config --set-model gemini-2.5-pro

# Show current settings
research-agent config --show

🔧 Commands

research-agent search <query>

Run AI-powered research on a topic and generate a comprehensive report.

Options:

• --output, -o: Save results to file
• --model, -m: Specify AI model
• --verbose, -v: Show detailed logs

research-agent config

Manage configuration settings.

Options:

• --show: Display current configuration
• --set-model: Change default AI model