Skip to content

arXiv digest

CI Release License: MIT Python: 3.12+ Docs

arXiv Digest: your arXiv, ranked by rules you control. A ranked paper card with followed authors and a matched keyword highlighted, its score, and Save to Zotero, Add author, Open PDF and Remove buttons

arXiv Digest reads the new papers in the arXiv categories you follow and ranks them by your own keywords, authors and categories, so the papers you care about come first.

  • Rules, not a language model. Every score comes with a breakdown of what matched. No API key, no account.
  • Any category. quant-ph, hep-th, cs.LG, math.AG, …
  • Built for reading. Matches are highlighted, Zotero is one click away, and papers you've read can be removed so the next one moves up.
  • Web app, iPhone app and CLI, with the same features and the same config.

Quick start

You need uv (curl -LsSf https://astral.sh/uv/install.sh | sh on macOS and Linux).

git clone https://github.com/isaac-tes/arxiv-digest.git
cd arxiv-digest
uv tool install '.[gui]'
arxiv-gui                     # opens the web app at http://localhost:8501

Click Fetch papers, then start from a starter preset or type your own keywords and authors. The list re-ranks as you edit. Update later with arxiv-digest update.

A tour of the web app: fetching the past week, hovering highlighted keywords and authors to see their bonus, Why this score?, picking a day, searching, Markdown export, saving to a Zotero collection, the PDF, following an author with the unsaved-changes bar, removing and restoring a paper, scoring an arXiv link, the Keywords, Scoring and Profiles tabs, config as JSON, server sync and highlight colors

Watch it as full-quality video

Also available

  • 📱 iPhone and iPad app (preview). Works on its own, fetching and scoring on the phone, or shares your settings with the web app through a small self-hosted server. Not on the App Store yet: install it with Xcode.
  • ⌨️ CLI. arxiv-digest --top 10 prints the same ranking in the terminal, or writes Markdown and JSON for cron jobs and notes apps. It reads the same arxiv_config.json as the web app. See the CLI guide.

Documentation
Quickstart Install options, updating, running from a clone
GUI guide Every tab, highlighting, Zotero, profiles and presets
Scoring The rules, default weights and how to tune them
CLI guide All flags, the config file, output formats
iPhone app Install, modes, web ↔ iOS feature table
Sync across devices Run the digest server, connect your devices
Troubleshooting Common problems and fixes

Or browse them all on the documentation site.

Similar projects

AutoLLM/ArxivDigest asks GPT how relevant each paper is to a description of your interests and emails you the result. It needs an OpenAI key and a SendGrid account and hasn't been updated since May 2024. arXiv Digest is unrelated to it and shares no code: it scores with rules you can read and change, runs locally on demand, and adds the browser and iPhone apps and Zotero saving. Both are MIT-licensed.

Contributing

Bug reports and pull requests are welcome; see CONTRIBUTING.md. uv sync --group dev && uv run pytest runs the test suite (no network needed).