A professional-grade, autonomous research agent powered by LangChain and Groq LLMs. This tool intelligently searches the web, analyzes academic sources, and compiles structured research reports on any given topic.
- Autonomous Agentic Workflow: Uses the ReAct (Reason + Act) pattern to dynamically plan and execute research.
- Smart Web Search: Integrates with DuckDuckGo to find high-quality, relevant sources.
- Intelligent Summarization: Reads and distills complex web pages using Llama 3 models.
- Rate-Limit Resilient: detailed "Mellow Mode" architecture ensures stability even on free API tiers.
- Zero Cost: Built entirely on free tools (Groq API + DuckDuckGo).
- Python 3.11+
- LangChain: For agent orchestration and tool management.
- Groq: For ultra-fast Llama 3 inference.
- BeautifulSoup4: For robust web scraping.
- Clone the Repository (if applicable)
- Create a Virtual Environment (Recommended):
python -m venv venv # Windows venv\Scripts\activate # Mac/Linux source venv/bin/activate
- Install Dependencies:
pip install -r requirements.txt
- Obtain a free API Key from Groq Console.
- Create a
.envfile in the project root:cp .env.example .env
- Add your API key to the
.envfile:GROQ_API_KEY=gsk_your_actual_api_key_here
Run the agent via the command line:
# Ensure your virtual environment is active
python main.pyFollow the prompts to enter your research topic (e.g., "Quantum Computing applications in Finance"). The agent will:
- Think: Formulate a search strategy.
- Search & Read: Gather information from multiple sources.
- Write: Generate a comprehensive markdown report (
report.md) in the current directory.