explaingit

dzhng/deep-research

18,933TypeScriptAudience · developerComplexity · 2/5MaintainedLicenseSetup · moderate

TLDR

AI research assistant that automatically investigates topics by searching the web, extracting insights, and generating follow-up questions until it builds a comprehensive report.

Mindmap

mindmap
  root((repo))
    What it does
      Automated research loops
      Web search and extraction
      Generates follow-up questions
      Compiles markdown reports
    How to use it
      Set breadth parameter
      Set depth parameter
      Enter research question
      Get comprehensive report
    Use cases
      Competitive research
      Technical investigation
      Academic background reading
    Tech stack
      TypeScript
      OpenAI API
      Firecrawl web scraping
    Requirements
      Firecrawl API key
      OpenAI API key
      Local AI models optional

Things people build with this

USE CASE 1

Quickly research competitors by automatically gathering and synthesizing information about their products, strategies, and market position.

USE CASE 2

Investigate technical topics deeply by having the AI search for explanations, examples, and related concepts across multiple sources.

USE CASE 3

Build academic background reading by automatically exploring a subject from multiple angles and compiling sources into a structured report.

USE CASE 4

Explore new domains or industries by setting breadth and depth parameters to control how thoroughly the AI investigates.

Tech stack

TypeScriptOpenAIFirecrawlNode.js

Getting it running

Difficulty · moderate Time to first run · 30min

Requires OpenAI API key and Firecrawl API key to function.

Use freely for any purpose including commercial, as long as you keep the copyright notice.

In plain English

Open Deep Research is an AI-powered research assistant that automatically investigates any topic by combining web searches, content extraction, and large language models (AI text systems like GPT). The problem it solves: researching a complex topic thoroughly requires multiple rounds of searching, reading, connecting ideas, and generating new questions, a tedious process when done manually. This tool automates that loop. Here's how it works: you enter a research question and set two parameters, "breadth" (how many parallel search threads to pursue) and "depth" (how many levels of follow-up exploration to do). The system generates targeted search queries using an AI model, searches the web via Firecrawl (a web scraping service), extracts the key learnings from the results, identifies new research directions those findings suggest, and then recursively searches those directions. After completing all iterations, it compiles everything into a comprehensive Markdown report with sources. You would use this when you need to deeply understand a topic quickly, competitive research, technical investigation, academic background reading, and want the AI to do the iterative "what should I read next" work for you. It requires a Firecrawl API key for web search and an OpenAI API key (for the o3-mini model) or can use local AI models via OpenAI-compatible endpoints. The codebase is intentionally kept under 500 lines of TypeScript so it's easy to understand and build on.

Copy-paste prompts

Prompt 1
I want to research 'machine learning in healthcare' with breadth 3 and depth 2. Use this repo to automatically search the web, extract key findings, and generate a comprehensive markdown report with sources.
Prompt 2
Set up Open Deep Research to investigate 'competitive landscape of AI coding assistants' by configuring my Firecrawl and OpenAI API keys, then run a research query with high breadth to explore multiple angles.
Prompt 3
Use this TypeScript codebase to build a research assistant that takes a question about 'renewable energy trends', automatically generates search queries, scrapes results, and recursively explores new research directions.
Prompt 4
I need to understand 'blockchain scalability solutions' quickly. Configure Open Deep Research with depth 3 to do multiple levels of follow-up exploration and compile everything into a single markdown report.
Prompt 5
Modify this repo to research 'emerging AI safety techniques' by adjusting the breadth and depth parameters, then integrate it into my workflow to automatically generate research reports on demand.
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.