Skip to main content

AI-optimized arXiv paper reader. Converts academic papers into LLM-legible Markdown with structural annotations.

Project description

paper-digest

Convert arXiv papers to AI-optimized Markdown. Math-perfect, section-tagged, noise-free.

pip install git+https://github.com/jingxuan/paper-digest.git
paper-digest 2412.15185

Install

pip install git+https://github.com/jingxuan/paper-digest.git

Or install from local source:

git clone https://github.com/jingxuan/paper-digest.git
cd paper-digest
pip install -e .

Why

Feeding a PDF to Claude/GPT costs 30k+ tokens per paper. Most of it is formatting noise. If you're screening 100 papers, that's 3M tokens wasted.

paper-digest converts arXiv papers to clean Markdown with:

  • LaTeX math preserved as-is$\mathcal{L} = \sum_i \ell_i$, not garbled MathML
  • Section tags## [METHOD] 3.1 Our Approach so your AI can skip to what matters
  • Noise removed — no headers/footers, acknowledgements, or page numbers

A 30k-token PDF becomes ~10k chars of structured Markdown. Use --sections abstract,method to cut it to ~3k.

Usage

CLI

# Full paper
paper-digest 2412.15185

# Just abstract + method (saves ~74%)
paper-digest 2412.15185 --sections abstract,method

# JSON output
paper-digest 2412.15185 --format json

# Batch processing
paper-digest --batch ids.txt --output ./papers/

# Keep everything (don't trim acknowledgements/appendix)
paper-digest 2412.15185 --raw

# Prefer HTML path (faster, but math may have artifacts)
paper-digest 2412.15185 --prefer-html

Python API

from paper_digest import PaperDigest

pd = PaperDigest()

paper = pd.fetch("2412.15185")
print(paper.markdown)            # Full AI-optimized Markdown
print(paper.section("method"))   # Just the method section
print(paper.metadata)            # Title, authors, date, section tags

# Filter sections
paper = pd.fetch("2412.15185", sections=["abstract", "method"])

# Batch
results = pd.fetch_batch(["2412.15185", "2302.13971"])

Input formats

All of these work:

2412.15185
2412.15185v2
hep-ph/0301012
https://arxiv.org/abs/2412.15185
https://arxiv.org/pdf/2412.15185.pdf

How it works

arXiv ID → LaTeX source (default) or HTML → parse → tag sections → trim noise → Markdown

Two conversion paths, automatic fallback:

Path Coverage Math quality Speed
LaTeX (default) 90%+ arXiv papers Perfect (native LaTeX) ~3s
HTML (fallback) 2024+ papers Good (occasional MathML artifacts) ~2s

Default is LaTeX-first because math formulas are kept verbatim from the source — no conversion, no loss. Use --prefer-html if you want speed over math fidelity.

Output format

---
arxiv_id: "2412.15185"
title: "Tiled Diffusion"
authors: ["Or Madar", "Ohad Fried"]
date: "2024-12-19"
sections: ["ABSTRACT", "INTRODUCTION", "METHOD", "EXPERIMENTS", "CONCLUSION", "REFERENCES"]
---

## [ABSTRACT] Abstract

Image tiling — the seamless connection of disparate images...

## [METHOD] 3 Method

Given a set of desired output images $\mathcal{I}=\{I_1, I_2, ..., I_N\}$...

Section tags

Tag Matches
ABSTRACT Abstract
INTRODUCTION Introduction, Background, Motivation
RELATED_WORK Related Work, Prior Work, Literature Review
METHOD Method, Methodology, Our Approach, Model Architecture, ...
EXPERIMENTS Experiments, Experimental Setup, Evaluation, ...
RESULTS Results, Main Results, Analysis, Discussion
CONCLUSION Conclusion, Summary, Future Work
REFERENCES References, Bibliography
OTHER Anything else (original title preserved)

Motivation

Transforming human knowledge from human-first and human-legible to LLM-first and LLM-legible is a beautiful space with so much potential... This would be a significantly richer source of legible, workable information for an LLM than just something like pdf-to-text (current prevailing practice), which simply asks the LLM to predict the textbook content top to bottom token by token (umm - lame).

Andrej Karpathy, 2025-08-28

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

paper_digest-0.1.0.tar.gz (19.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

paper_digest-0.1.0-py3-none-any.whl (20.5 kB view details)

Uploaded Python 3

File details

Details for the file paper_digest-0.1.0.tar.gz.

File metadata

  • Download URL: paper_digest-0.1.0.tar.gz
  • Upload date:
  • Size: 19.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.12

File hashes

Hashes for paper_digest-0.1.0.tar.gz
Algorithm Hash digest
SHA256 0fa0103df800aa56a376d6355557a7b74e30549b6d2d83561c40cc070400c6b3
MD5 3fcf39745392974c82198c751d0bf9d0
BLAKE2b-256 1b825921b9409349ff012fc4f07017db086e9aab61a703fa6ebc0173fe2688de

See more details on using hashes here.

File details

Details for the file paper_digest-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: paper_digest-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 20.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.12

File hashes

Hashes for paper_digest-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b7335ba7b0caf22f794863f132b8adad29f069964609e39ffb8dff772fce3a30
MD5 8c2b4b778b563a0b3698d91057c06b6d
BLAKE2b-256 d1366c5a44ddc6475726603d8d971327428d0bc7c9f6b93da9319cb3d3e1f92c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page