---
title: ChronoQuery
emoji: 🏆
colorFrom: red
colorTo: blue
sdk: streamlit
sdk_version: 1.50.0
pinned: false
short_description: Unlock the past — ask about any historical event and get ins
---

**ChronoQuery** is an intelligent, AI-powered historical event explainer that allows users to explore the past interactively.  
Just type in a historical event, figure, or question — and get **instant, research-backed insights** compiled from reliable sources like **Wikipedia** and **DuckDuckGo Search**, all refined through **Google’s Gemini AI**.  

---

## 🧠 What It Is  

ChronoQuery is an **AI history assistant** built with **Streamlit** and **LangChain**, powered by **Google’s Gemini 2.5 Flash model**.  
It’s designed to help users learn about historical topics effortlessly — whether you’re a student, researcher, or just curious about world events.  

---

## ⚙️ What It Does  

✅ Takes any historical question or event as input  
✅ Automatically identifies the **core topic or event** using an AI-based topic extractor  
✅ Fetches relevant content from **Wikipedia** and **DuckDuckGo**  
✅ Combines and refines the data using **Gemini AI** for an accurate, contextualized answer  
✅ Displays results in an elegant, user-friendly Streamlit interface  

---

## 🔍 How It Works  

ChronoQuery uses a modular AI workflow powered by **LangChain Runnables**:  

1. **User Query → Topic Extraction**  
   - The app identifies the main topic or event using Gemini’s language understanding.  

2. **Knowledge Retrieval**  
   - Fetches relevant summaries from **Wikipedia** (via `WikipediaRetriever`).  
   - Collects additional web context using **DuckDuckGo Search**.  

3. **Data Combination**  
   - Both Wikipedia and web data are merged into a unified context string.  

4. **AI Reasoning & Summarization**  
   - The combined data is sent to **Gemini 2.5 Flash**, which formulates a detailed, coherent response.  

5. **Output Rendering**  
   - Streamlit displays the results beautifully, allowing users to query multiple times interactively.  

---

## 🧩 Technologies Used  

| Component | Technology / Library | Purpose |
|------------|----------------------|----------|
| 🧱 Framework | **Streamlit** | Builds the interactive web interface |
| 🧠 AI Model | **Google Gemini 2.5 Flash (via `google.generativeai`)** | Generates contextual answers |
| 🔗 Orchestration | **LangChain (core, community)** | Manages chains, prompts, and data flow |
| 📚 Knowledge Base | **WikipediaRetriever** | Retrieves factual content |
| 🌐 Web Search | **DuckDuckGoSearchRun** | Adds recent or broader information |
| 🧩 Utilities | **RunnableLambda, RunnableParallel, StrOutputParser** | Custom data pipelines and parsing |
| 💾 Language | **Python 3.10+** | Main development language |

---