Skip to main content

arDive: a simple dive into your ArXiv

PyPI

A small command-line agent that pulls papers from arXiv and uses Llama3.2 to summarize, explain, compare, and digest them. Anyone can easily install and use without the need of a paid plan.

Install

# 1. Install Ollama (free, runs models locally): https://ollama.com
ollama pull llama3.2:1b     # the fast default; or any open model you like

# 2. Install arDive
pip install ardive

That's it. arDive talks to the local Ollama server. Pick a different model with ARDIVE_MODEL (e.g. export ARDIVE_MODEL=qwen2.5), or point at a remote Ollama with OLLAMA_HOST.

From source

git clone https://github.com/rohankosalge/arDive
cd arDive
pip install -e .

Usage

# Summarize a paper as bullet points
ardive sum 1234.56789

# Focus on one section, cap the bullets
ardive sum 1234.56789 --section methodology --max-bullets 5

# Explain like I'm 5 (works on every command)
ardive sum 1234.56789 --eli5

# Compare papers (similarities + a differences table)
ardive comp 1234.56789 9876.54321

# List papers on a topic (fast; no model)
ardive dig "diffusion models for protein folding"
ardive dig "graph neural networks" -n 5

# List papers similar to a given one (fast; no model)
ardive sim 1234.56789 -n 5

Commands

Command What it does
sum <id> Bullet-point summary of one paper (full PDF text).
comp <id> <id> [...] Compare papers: a Title A vs Title B header, a Similarities bullet list, and a Differences table.
dig <topic> Search arXiv by topic; a numbered list of papers (title + arXiv id). Pure arXiv lookup — no model, very fast.
sim <id> List papers similar to the given one (title + arXiv id), scoped to its arXiv category. Pure arXiv lookup — no model, very fast.

Flags

  • --eli5 — explain in plain, jargon-free language (sum, comp).
  • --section {abstract,intro,methodology,related,citations} — sum only; focus on one section.
  • --max-bullets N — sum only; hard cap on the number of bullets (positive integer).
  • -n/--num N — dig and sim; how many papers to list (default 3).

How it works

sum and comp download each paper's PDF and extract its full text, then send it to a local open-source model via Ollama (default llama3.2:1b) with a prompt tailored to the command. dig and sim use no model — they're pure arXiv lookups that just list papers, so they're fast. In a terminal the response is rendered as formatted Markdown inside a box; when piped or redirected (e.g. ardive sum 1234.56789 > out.md) it's written as plain Markdown so the file stays clean.

Long papers can exceed the model's context window and be truncated. arDive asks Ollama for an 8192-token window by default; raise it (at the cost of more RAM) with export ARDIVE_NUM_CTX=16384.

Speed

Summaries run entirely on your machine, so wall-clock time is dominated by the model. A few levers:

  • Model choice is the biggest one. The default llama3.2:1b is fast but modest in quality; for better summaries (slower) try export ARDIVE_MODEL=llama3.2 (~3B) or export ARDIVE_MODEL=qwen2.5:3b. 7B+ models are noticeably slower on full papers.
  • Abstract is near-instant. ardive sum <id> --section abstract skips the PDF download and summarizes just the abstract.
  • First run is slowest. It loads the model into memory; arDive keeps it warm for 15 min afterward (tune with ARDIVE_KEEP_ALIVE), so repeat runs are quicker.
  • Smaller asks finish sooner. --max-bullets N shortens the output, and a lower ARDIVE_NUM_CTX trades context for speed.

Metadata

Release files for ardive 0.1.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ardive 0.1.6
File Size Uploaded Provenance
ardive-0.1.6.tar.gz 11.5 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for ardive 0.1.6
File Interpreter ABI Platform
ardive-0.1.6-py3-none-any.whl Python 3 none any Details

Total release size: 22.8 kB

Release files / ardive-0.1.6.tar.gz

Download URL ardive-0.1.6.tar.gz
Size 11.5 kB
Tags Source
SHA-256 checksum
How to use checksums
1aea700b60a49ef5419423cee19ecea85232366961a9250295711d656b48b0f8
BLAKE2b-256 checksum
How to use checksums
b158e7971962e68466b15e76967be0fa878ba8c5dd61f353fc98bb7cc23deeb6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.12

Release files / ardive-0.1.6-py3-none-any.whl

Download URL ardive-0.1.6-py3-none-any.whl
Size 11.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3c96c7b2f56698c130c6c83d7af2fc8f069abaa8d86b611c635b4fdad39276be
BLAKE2b-256 checksum
How to use checksums
d6e993733e0f0a980b2e03495339c9890d40ee32b24af8659a04e7df77aeabae
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.12

Security for ardive 0.1.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page