✨ Open Web Researcher ✨

<p align="center"> <img src="https://img.shields.io/github/stars/BlackTechX011/OpenWebResearcher?style=for-the-badge&logo=github&color=yellow" alt="GitHub stars"> <img src="https://img.shields.io/github/forks/BlackTechX011/OpenWebResearcher?style=for-the-badge&logo=github&color=green" alt="GitHub forks"> <img src="https://img.shields.io/github/issues/BlackTechX011/OpenWebResearcher?style=for-the-badge&logo=github&color=red" alt="GitHub issues"> <img src="https://img.shields.io/github/license/BlackTechX011/OpenWebResearcher?style=for-the-badge&logo=apache" alt="GitHub license"> <img src="https://img.shields.io/github/last-commit/BlackTechX011/OpenWebResearcher?style=for-the-badge&logo=git&color=purple" alt="Last commit"> <img src="https://img.shields.io/badge/Status-Active-brightgreen?style=for-the-badge&logo=github-actions" alt="Project status"> <img src="https://img.shields.io/badge/Platform-Cross--platform-lightgrey?style=for-the-badge&logo=windows" alt="Platform"> </p>

 ██████╗ ██████╗ ███████╗███╗   ██╗    ██╗    ██╗███████╗██████╗     ██████╗ ███████╗███████╗███████╗ █████╗ ██████╗  ██████╗██╗  ██╗███████╗██████╗ 
██╔═══██╗██╔══██╗██╔════╝████╗  ██║    ██║    ██║██╔════╝██╔══██╗    ██╔══██╗██╔════╝██╔════╝██╔════╝██╔══██╗██╔══██╗██╔════╝██║  ██║██╔════╝██╔══██╗
██║   ██║██████╔╝█████╗  ██╔██╗ ██║    ██║ █╗ ██║█████╗  ██████╔╝    ██████╔╝█████╗  ███████╗█████╗  ███████║██████╔╝██║     ███████║█████╗  ██████╔╝
██║   ██║██╔═══╝ ██╔══╝  ██║╚██╗██║    ██║███╗██║██╔══╝  ██╔══██╗    ██╔══██╗██╔══╝  ╚════██║██╔══╝  ██╔══██║██╔══██╗██║     ██╔══██║██╔══╝  ██╔══██╗
╚██████╔╝██║     ███████╗██║ ╚████║    ╚███╔███╔╝███████╗██████╔╝    ██║  ██║███████╗███████║███████╗██║  ██║██║  ██║╚██████╗██║  ██║███████╗██║  ██║
 ╚═════╝ ╚═╝     ╚══════╝╚═╝  ╚═══╝     ╚══╝╚══╝ ╚══════╝╚═════╝     ╚═╝  ╚═╝╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝

---

🌐 Overview

Open Web Researcher 🤖 is an AI-powered research companion that automates web research, delivering concise and insightful reports. Using state-of-the-art Large Language Models (LLMs), this tool refines queries, extracts content, and generates structured reports in Markdown format, making your research process seamless and efficient.

---

🌟 Key Features

🚀 Automated Web Research

Perform in-depth, efficient web searches tailored to your queries.

📊 Highly Detailed Report Generation

Generate comprehensive, structured, and insightful reports effortlessly.

🔍 Deep Dive into Any Topic

Unlock a profound understanding of complex subjects with expert-level analysis.

💾 Markdown Export

Create shareable, easy-to-read Markdown reports perfect for collaboration and presentation.

💡 The Best Free, Open-Source Alternative

A superior, cost-free alternative to tools like SearchGPT and Perplexity.

🎯 ...And More!

Packed with additional features to revolutionize your web research experience.

---

🛠️ Installation

1️⃣ Clone the Repository:

git clone https://github.com/BlackTechX011/OpenWebResearcher.git  
cd OpenWebResearcher  

2️⃣ Install Dependencies:

pip install -r requirements.txt  

3️⃣ Configure API Keys:

Update config/settings.py with your API keys:

# --- Configuration ---  
API_KEYS = ["YOUR_FIRST_API_KEY", "YOUR_SECOND_API_KEY"]  
FINAL_REPORT_MODEL_API_KEY = "YOUR_FINAL_REPORT_API_KEY"  

[!NOTE] You can get your API keys from https://aistudio.google.com/apikey

---

🎮 Usage

1. Run the script:

   python OpenWebResearcher.py  
   

2. Enter your query when prompted.
3. Relax as Open Web Researcher delivers a beautifully formatted report.

---

📊 How It Works

+-------------------------+
|       🚀 START          |
+-------------------------+

            👇
+-------------------------+
| 1. QUERY REFINEMENT     |
|    Expand into          |
|    subtopics            |
+-------------------------+
            👇
+-------------------------+
|   2. WEB SEARCH         |
|   Extensive search      |
|   per subtopic          |
+-------------------------+
            👇
+-------------------------+
| 3. CONTENT EXTRACTION   |
|   Extract essence from  |
|   relevant pages        |
+-------------------------+
            👇
+-------------------------+
|  4. SUMMARIZATION       |
|   Use LLMs for key      |
|   points                |
+-------------------------+
            👇
+-------------------------+
| 5. REPORT GENERATION    |
|   Combine into an       |
|   insightful report     |
+-------------------------+
            👇
+-------------------------+
| 6. MARKDOWN EXPORT      |
|   Deliver in            |
|   Markdown format       |
+-------------------------+
            👇
+-------------------------+
|        🎉 END          |
+-------------------------+

---

🤝 Contributing

We welcome contributions! 🚀 Follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Make changes and commit them.
4. Submit a pull request.

---

📜 License

This project is licensed under the MIT License. See the LICENSE file for details.

---

📫 Contact

• GitHub: BlackTechX011

---

🚀 Let Open Web Researcher transform your research process!