whatisgithub

What is paperpilot?

chb-learner/paperpilot — explained in plain English

Analysis updated 2026-05-18

33PythonAudience · researcherComplexity · 3/5Setup · moderate

In one sentence

A command line research agent that turns one research request into a full literature review, searching many academic databases and producing a bilingual evidence-based report.

Mindmap

mindmap
  root((PaperPilot))
    What it does
      Literature search agent
      Evidence based reports
      Bilingual output
    Tech stack
      Python
      CLI
      OpenAI compatible LLM
    Use cases
      Academic literature review
      Research reports
      Obsidian export
    Sources
      arXiv
      PubMed
      Semantic Scholar
    Audience
      Researchers
      Academics

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

Run a single command to generate a full literature review on a research topic.

USE CASE 2

Search across arXiv, PubMed, Semantic Scholar, and other academic databases at once.

USE CASE 3

Export research findings as Markdown, HTML, PDF, or Obsidian notes.

USE CASE 4

Try a lightweight version of the search in a browser without installing anything.

What is it built with?

PythonCLIOpenAI-compatible LLMCloudflare Workers

How does it compare?

chb-learner/paperpilot410979729/scope-recallarahim3/mlx-dspark
Stars333333
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity3/53/53/5
Audienceresearcherdeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an OpenAI-compatible LLM API key configured before first use.

So what is it?

PaperPilot is a command line research agent built for reviewing scientific literature in fields such as artificial intelligence, biomedicine, and AI for science. A user gives it one research request in plain language, and it builds a full workflow around that request: it writes a search plan with rules for what papers to include or exclude, queries many literature databases at once, removes duplicates, and sorts papers into core, adjacent, and excluded groups. It checks whether each paper's link, PDF, or code is actually reachable, without bypassing any paywalls. Once the screening is done, PaperPilot pulls together the evidence into a report, written in both Chinese and English, with numbered citations tied back to specific sources. Reports come out as Markdown, HTML, and PDF files, and can also be exported to Obsidian as linked notes covering papers, methods, topics, and claims. Every run is saved in its own folder with logs and intermediate files, so the process can be inspected or resumed later. The default free sources include arXiv, Semantic Scholar, OpenAlex, Crossref, OpenReview, PubMed, Europe PMC, bioRxiv, medRxiv, DBLP, ACL Anthology, and Papers.cool. Paid sources with their own API keys, such as IEEE Xplore, Springer Nature, Elsevier, Dimensions, and Lens.org, can be added for wider coverage. The tool also has an interactive shell with commands like /model to switch between language model profiles, /sources to check which databases are working, and /doctor to run a quick health check. There is also a lighter online demo running on Cloudflare Workers, which lets someone try a smaller version of the search and download a basic Markdown or HTML report from public paper metadata, without installing anything. The full command line version is the complete tool, meant for screened collections of papers, full text handling, and generating the bilingual PDF reports. To use PaperPilot, you install it with pip and connect it to any OpenAI-compatible language model by editing a configuration file that is created automatically the first time it runs. The project is written in Python and is aimed at researchers who want a repeatable, traceable way to build literature reviews instead of doing it by hand.

Copy-paste prompts

Prompt 1
Use PaperPilot to search for recent papers on my research topic and generate a bilingual literature review report.
Prompt 2
Set up PaperPilot with my OpenAI-compatible API key and run a literature search limited to papers published after 2021.
Prompt 3
Explain how PaperPilot verifies that a paper's PDF and code links are actually working before including it in a report.
Prompt 4
Walk me through exporting a PaperPilot literature review into Obsidian as linked notes.

Frequently asked questions

What is paperpilot?

A command line research agent that turns one research request into a full literature review, searching many academic databases and producing a bilingual evidence-based report.

What language is paperpilot written in?

Mainly Python. The stack also includes Python, CLI, OpenAI-compatible LLM.

How hard is paperpilot to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is paperpilot for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.