deep-research-py  by epuerta9

CLI tool for AI-powered research and report generation

created 5 months ago
413 stars

Top 71.9% on sourcepulse

GitHubView on GitHub
Project Summary

This Python CLI tool, Deep Research Assistant PY, automates in-depth topic exploration by combining AI analysis with web search. It's designed for researchers, students, or anyone needing to quickly synthesize information from multiple online sources, offering a cost-effective alternative to paid research services.

How It Works

The tool leverages AI models (OpenAI or DeepSeek) for understanding user queries, generating follow-up questions to refine the research scope, and synthesizing findings. It integrates with Firecrawl for reliable web content extraction, processing and splitting text to manage large documents. The core advantage lies in its interactive approach, allowing users to guide the research depth and breadth, leading to more focused and comprehensive results.

Quick Start & Requirements

  • Install via uv tool install deep-research-py.
  • Requires Python 3.9+, an OpenAI API key (GPT-4 recommended), and a Firecrawl API key.
  • Docker setup is available for integration with OpenAI-compatible clients like OpenWebUI.
  • Official docs: https://github.com/epuerta9/deep-research-py

Highlighted Details

  • Interactive research with customizable breadth (2-10) and depth (1-5).
  • Web content extraction via Firecrawl.
  • Generates markdown reports with summaries and detailed analysis.
  • Supports concurrency for faster processing with high API rate limits.

Maintenance & Community

Contributions are welcome via standard GitHub pull requests. Pre-commit hooks are configured for development.

Licensing & Compatibility

MIT License. Permissive for commercial use and integration with closed-source projects.

Limitations & Caveats

Requires API keys for core functionality (OpenAI/DeepSeek, Firecrawl). Performance is dependent on API rate limits and Firecrawl's availability.

Health Check
Last commit

4 months ago

Responsiveness

1 week

Pull Requests (30d)
0
Issues (30d)
0
Star History
22 stars in the last 90 days

Explore Similar Projects

Starred by Tobi Lutke Tobi Lutke(Cofounder of Shopify), Chip Huyen Chip Huyen(Author of AI Engineering, Designing Machine Learning Systems), and
7 more.

firecrawl by mendableai

1.9%
44k
API service for turning websites into LLM-ready data
created 1 year ago
updated 1 day ago
Feedback? Help us improve.