whatisgithub

What is deep-research?

hoolulu/deep-research — explained in plain English

Analysis updated 2026-05-18

110PythonAudience · researcherComplexity · 2/5Setup · easy

In one sentence

An OpenCode plugin that runs a multi-stage research pipeline and produces a long, cited Markdown report on any topic in about six minutes.

Mindmap

mindmap
  root((repo))
    What it does
      Plans searches
      Runs web search
      Writes chapters
      Validates output
    Tech stack
      Python
      Scrapling
    Use cases
      Generate a report
      Cite sources
      Choose depth mode
    Audience
      Researchers
    Setup
      Slash command
      AI tool install

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Trigger a single slash command to research any topic automatically.

USE CASE 2

Get a cited Markdown report with data tables and counterarguments.

USE CASE 3

Choose between quick, standard, and deep research modes.

USE CASE 4

Run web searches across English and Chinese-language sources.

What is it built with?

PythonScraplingExa

How does it compare?

hoolulu/deep-research2417467487-hub/trend2video-prooliverleexz/serl
Stars110111109
LanguagePythonPythonPython
Setup difficultyeasymoderatehard
Complexity2/55/5
Audienceresearchervibe coderresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Installation can be delegated to the AI tool itself via a setup prompt.

So what is it?

This repository is a plugin, called a "skill," for the OpenCode AI coding tool. Its purpose is to run a structured research pipeline that produces a long, cited report on any topic you give it. You trigger it with a single slash command and the process runs automatically for about six minutes without further input. The output is a Markdown file containing roughly 15,000 Chinese characters, organized into eight or more chapters, each with numbered paragraphs, data tables, cited sources, and a section presenting counterarguments. The pipeline works in four stages. First it analyzes your topic and generates a search plan. Second it runs web searches using a service called Exa as the primary engine, falling back to DuckDuckGo, Bing, Semantic Scholar, and a set of Chinese-language sources including Zhihu, Baidu Baike, industry databases, and national statistics sites. A Python library called Scrapling fetches the full text of pages rather than just summaries. Third, multiple chapters are written in parallel by passing the collected facts directly into the language model prompt. Fourth, a validation and assembly step checks each paragraph, converts citation formats, and runs a quality pass before saving the file. Three depth modes are available: a quick mode that caps output at about 8,000 characters and takes five to eight minutes, a standard mode targeting 15,000 characters in six to ten minutes, and a deep mode going up to 25,000 characters in twelve to eighteen minutes. All processing stays on your local machine. No data is sent to external services beyond the search queries and language model API calls you already use. Although it was built for OpenCode, the README notes that the same approach works with Claude Code, Codex CLI, Cursor, Windsurf, and other AI coding tools with some adaptation. Installation can be handed to the AI tool itself by pasting a prompt that tells it to read the project documentation and set everything up.

Copy-paste prompts

Prompt 1
Explain the four stages this research pipeline runs through to produce a report.
Prompt 2
Help me install this skill into my AI coding tool and trigger it with a slash command.
Prompt 3
What is the difference between quick, standard, and deep mode in this tool?
Prompt 4
Show me how this pipeline falls back across search engines if Exa is unavailable.

Frequently asked questions

What is deep-research?

An OpenCode plugin that runs a multi-stage research pipeline and produces a long, cited Markdown report on any topic in about six minutes.

What language is deep-research written in?

Mainly Python. The stack also includes Python, Scrapling, Exa.

How hard is deep-research to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is deep-research for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.