whatisgithub

What is paperwise?

hjcheng0602/paperwise — explained in plain English

Analysis updated 2026-05-18

50PythonAudience · researcherComplexity · 3/5LicenseSetup · moderate

In one sentence

A command line tool that deeply reads research papers with AI, producing structured six section reports and a knowledge graph across papers.

Mindmap

mindmap
  root((Paperwise))
    What it does
      Deep reads a single paper
      Six section structured report
      Builds knowledge graph
    Tech stack
      Python
      ChromaDB
      DeepSeek or Qwen or OpenAI or Anthropic
    Use cases
      Deep reading a paper
      Surveying a research area
      Searching a knowledge base
    Audience
      Researchers
      Graduate students
    Features
      Vector knowledge base
      Multiple LLM calls per report
      Interactive knowledge graph
    Setup
      pip install
      API key in env file
      Choice of LLM provider

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

Generate a structured six section report explaining a single research paper by its arXiv ID.

USE CASE 2

Search recent arXiv papers and produce a summary of an entire research area.

USE CASE 3

Build an interactive knowledge graph showing how concepts and papers connect to each other.

What is it built with?

PythonChromaDBDeepSeekQwenOpenAIAnthropic

How does it compare?

hjcheng0602/paperwisekulunkilabs/vibenetbackuppyvista/pyvista-cad
Stars505050
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity3/53/53/5
Audienceresearcherops devopsresearcher

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 API key from a supported LLM provider, though local embeddings can avoid a second API key.

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Paperwise, also called research-helper in its own files, is a command line tool that helps researchers read academic papers more deeply using AI language models. Rather than just asking an AI to summarize a paper in one shot, it runs a longer pipeline: it builds a vector based knowledge base to reduce made up answers, calls the language model multiple separate times for more depth, and tracks how ideas connect across papers in a knowledge graph. The main command reads a single paper, either by its arXiv ID or a local PDF file, and produces a structured report in six sections: the research problem and motivation, the core method including any formulas or architecture, the experiment design and results, a comparison with related work pulled automatically from the knowledge base, the paper's limitations and future directions, and a personal evaluation with research ideas it might inspire. Each of these six sections is generated by its own separate call to the language model rather than one combined request. Beyond single papers, the tool can search arXiv and produce a broader summary of a research area, search the built up knowledge base by meaning rather than exact keywords, and build an interactive knowledge graph from all the papers read so far. That graph connects concept nodes, like specific methods or techniques, to the papers that use them, and shows relationships such as one paper building on, comparing to, or contradicting another. The graph can be opened directly in a browser or exported for use in a separate graph visualization tool called Gephi. Setup involves cloning the repository, installing it with pip, and adding an API key to a configuration file. It supports several language model providers including DeepSeek, Qwen, OpenAI, and Anthropic, and can generate its own text embeddings locally without any API key if none of the cloud embedding providers are configured. The README estimates that reading one paper costs roughly 0.002 to 0.005 dollars in API fees. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me install paperwise and configure it to use the DeepSeek API for reading papers.
Prompt 2
Run rh read on the Attention Is All You Need paper and explain what each of the six report sections covers.
Prompt 3
Help me set up local sentence-transformers embeddings so I don't need an API key for the knowledge base.
Prompt 4
Explain how paperwise's knowledge graph decides when one paper builds on or contradicts another.
Prompt 5
Help me use rh survey to generate an overview of a research area I'm new to.

Frequently asked questions

What is paperwise?

A command line tool that deeply reads research papers with AI, producing structured six section reports and a knowledge graph across papers.

What language is paperwise written in?

Mainly Python. The stack also includes Python, ChromaDB, DeepSeek.

What license does paperwise use?

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is paperwise to set up?

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

Who is paperwise for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.