whatisgithub

What is read-summarize-papers?

angelamer/read-summarize-papers — explained in plain English

Analysis updated 2026-05-18

8PythonAudience · researcherComplexity · 3/5LicenseSetup · moderate

In one sentence

A command line tool that pulls new papers from arXiv and Zotero, has an AI analyze them against your research questions, and writes organized Obsidian notes.

Mindmap

mindmap
  root((repo))
    What it does
      Paper fetching
      Two tier analysis
      Obsidian notes
    Tech stack
      Python
      Zotero
      Obsidian
    Use cases
      Literature review
      Research tracking
    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

Automatically fetch new arXiv papers matching your research keywords every day

USE CASE 2

Have an AI summarize or deeply analyze papers against your own research questions

USE CASE 3

Build a searchable, organized archive of paper notes inside Obsidian

USE CASE 4

Find and clean up duplicate papers in a Zotero library

What is it built with?

PythonObsidianZotero APIAnthropic API

How does it compare?

angelamer/read-summarize-papers100/awesome-machine-learningadam-s/car-diagnosis
Stars888
LanguagePythonPythonPython
Last pushed2024-08-07
MaintenanceStale
Setup difficultymoderateeasymoderate
Complexity3/51/53/5
Audienceresearcherdeveloperresearcher

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs a Zotero account, an Obsidian vault, and an Anthropic or OpenAI-compatible API key.

Free to use, modify, and share for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

read-summarize-papers, called rsp for short, is a command line tool that helps researchers keep up with new academic papers without manually copying anything. It connects to your Zotero library, can automatically pull in new papers from arXiv based on keyword searches you define, and then uses an AI language model to read and analyze each paper against a set of questions you write in advance about your own research interests. The tool runs a two tier process to save cost and time. Papers are first screened against your research profile using a simple keyword match. Papers that only weakly match get a cheaper summary based on just the abstract, while papers that strongly match get a full analysis that reads the whole paper, answers your custom questions with evidence, and adds the paper to a visual research map. Every result is written as a structured note in Obsidian, organized by the date it was processed, so your notes build into a browsable archive over time. Beyond the main pipeline, rsp includes commands to find and merge duplicate entries in your library, attach PDF copies to your Zotero items, sort papers into collections based on keyword matches, search through everything you have processed, and check that your setup is configured correctly. Interrupted runs are safe to resume, since already processed papers are skipped and only the interrupted one is retried. To use it you need Python 3.9 or later, a Zotero account with an API key, an Obsidian vault, and an API key for an AI service such as Anthropic or any OpenAI compatible provider. Setup involves copying example configuration files, filling in your paths and API keys, and defining the arXiv sources and questions you care about. Once configured, a typical day involves running one command to fetch or sync new papers and another to process everything that is pending.

Copy-paste prompts

Prompt 1
Help me configure read-summarize-papers with my Zotero API key, Obsidian vault path, and Anthropic API key.
Prompt 2
Using rsp's question pack format, write a set of research questions for papers about my topic.
Prompt 3
Walk me through setting up an arXiv source in rsp's sources.yaml to auto-fetch papers on a specific keyword.

Frequently asked questions

What is read-summarize-papers?

A command line tool that pulls new papers from arXiv and Zotero, has an AI analyze them against your research questions, and writes organized Obsidian notes.

What language is read-summarize-papers written in?

Mainly Python. The stack also includes Python, Obsidian, Zotero API.

What license does read-summarize-papers use?

Free to use, modify, and share for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is read-summarize-papers to set up?

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

Who is read-summarize-papers for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.