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 paper-digest
paper-digest 2412.15185

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.1.tar.gz (19.2 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.1-py3-none-any.whl (20.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: paper_digest-0.1.1.tar.gz
  • Upload date:
  • Size: 19.2 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.1.tar.gz
Algorithm Hash digest
SHA256 a30953b90721ce9e9d3792c2b752d1c55c653d09a84be3c71aa6bee9c225c0df
MD5 30cde1a9798aa5365ad81284236ca232
BLAKE2b-256 c6abed5f210cd6e444e6be81b2b4a0ba32f950b05a488ea1f8d3b025cd857bcb

See more details on using hashes here.

File details

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

File metadata

  • Download URL: paper_digest-0.1.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 7061a1929c7e92ef09724b23da371012820e39ecdfc6e012f073c506e7dce252
MD5 fc4ec7ae423c2049712a3496a49ac207
BLAKE2b-256 c2be6908daa228e13f2a4168542a1a6b2d9648c6d9e2a34b527cc7520ba23061

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