---
title: AI Query Fan-Out Generator
emoji: 🚀
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 5.37.0
app_file: app.py
pinned: false
---

# 🚀 AI Query Fan-Out Generator

Transform a single query into multiple semantically related search queries to uncover deeper insights and comprehensive information.

## Features

- **Query Expansion**: Convert a single search query into 8-10 related queries
- **Semantic Analysis**: Generate queries that cover different aspects and intents
- **Query History**: Track and export your query generation sessions
- **Multiple Query Types**: 
  - Related queries
  - Implicit queries
  - Comparative queries
  - Reformulation queries
  - Entity-expanded queries

## How to Use

1. **Get a Gemini API Key**: 
   - Go to [Google AI Studio](https://makersuite.google.com/app/apikey)
   - Create a new API key
   - Copy the key

2. **Enter Your API Key**: 
   - Paste your Gemini API key in the "🔑 Gemini API Key" field
   - The status will show when the model is initialized

3. **Generate Fan-Out Queries**:
   - Enter your core prompt/query
   - Click "🧠 Generate Fan-Outs"
   - View the expanded queries and reasoning

4. **Manage History**:
   - View your query history in the sidebar
   - Export history as JSON
   - Clear history when needed

## Examples

### Input
```
best way to learn python for data analysis
```

### Output
- most effective python learning resources for data analysis beginners
- python data analysis tutorials with pandas and numpy
- best python courses for data science and analytics
- python vs R for data analysis comparison
- free python data analysis projects for practice
- python data visualization libraries matplotlib seaborn
- python data analysis certification programs
- python jupyter notebook setup for data analysis

## Technical Details

- **Model**: Google Gemini (1.5 Pro/Flash)
- **Framework**: Gradio
- **Response Format**: JSON with fan-out queries and reasoning chain
- **Temperature**: 0.7 for balanced creativity and consistency

## Privacy & Security

- Your API key is only used for your session and is not stored
- All processing happens through Google's Gemini API
- Query history is temporary and can be cleared at any time

## Support

For issues or questions, please check the [Gradio documentation](https://gradio.app/docs/) or [Google AI documentation](https://ai.google.dev/docs).