🔍 Deep Research Tool

The Deep Research Tool is an intelligent, agentic system that allows users to input any topic, automatically conducts in-depth research on it, generates a comprehensive report, and delivers the report directly to the user's email. It features an intuitive Gradio-based frontend and a modular backend powered by intelligent agents.

🚀 Features

• ✍️ Auto-generated Reports: Generate deep, well-structured reports on any topic.
• 🔎 Intelligent Agent Architecture: Modular agents handle planning, searching, writing, and emailing.
• 📩 Email Delivery: Completed reports are sent directly to your inbox.
• 🌐 User-Friendly Interface: Built with Gradio for a smooth and interactive user experience.

🧠 Agentic Architecture

This project uses multiple agents, each with a single responsibility:

• planner_agent.py: Plans and structures the research workflow.
• search_agent.py: Searches the web for credible information on the given topic.
• research_manager.py: Coordinates data flow and manages interactions between agents.
• writer_agent.py: Compiles findings into a coherent and professional report.
• email_agent.py: Sends the final report to the user via email.

🖥️ Frontend

• Built with Gradio for ease of use.
• Users simply type a topic and provide their email — the tool does the rest.

📦 Installation

git clone https://github.com/yourusername/deep-research-tool.git
cd deep-research-tool
pip install -r requirements.txt

✉️ Make sure to configure your email credentials securely (e.g., using .env for environment variables).

▶️ Usage

python app.py

Then open the Gradio interface (usually at http://127.0.0.1:7860) in your browser.

🛡️ Environment Variables

Create a .env file in your project root to store:

📧 Example

1. Open the app
2. Enter:
   • Topic: "Artificial Intelligence in Education"
3. Click Submit
4. Receive a detailed PDF report in your email within minutes!

📁 Folder Structure

deep-research-tool/
├── planner_agent.py
├── search_agent.py
├── research_manager.py
├── writer_agent.py
├── email_agent.py
├── deep_research.py
└── README.md

🙌 Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

🔗 Connect

Made with ❤️ by Ritesh Thakur