arDive: a simple dive into your ArXiv
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}—sumonly; focus on one section.--max-bullets N—sumonly; hard cap on the number of bullets (positive integer).-n/--num N—digandsim; 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:1bis fast but modest in quality; for better summaries (slower) tryexport ARDIVE_MODEL=llama3.2(~3B) orexport ARDIVE_MODEL=qwen2.5:3b. 7B+ models are noticeably slower on full papers. - Abstract is near-instant.
ardive sum <id> --section abstractskips 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 Nshortens the output, and a lowerARDIVE_NUM_CTXtrades 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)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| ardive-0.1.6.tar.gz | 11.5 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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.