Practical overview
When it fits
Use it to follow research interests across newly retrieved arXiv papers, especially when you want related-paper recommendations alongside search and sorting in a web interface.
Who it is for
- Researchers who want to organize arXiv papers around topics they follow.
- Readers looking for recommendations of new papers related to papers they have tagged.
- Operators who want to run a self-hosted arXiv monitoring and discovery site.
Documented uses
- Tag papers that represent a research interest.
- Find related new papers using recommendations based on those tags.
- Search, rank, sort and filter the collected paper results.
- Receive periodic email recommendations based on saved tags.
Requirements & limits
- The documented paper retrieval source is the arXiv API; another scholarly source would require changes to retrieval and data handling.
- Self-hosting requires installing the Python requirements and running separate retrieval, feature-computation and Flask-serving stages.
- Email recommendations are optional and use the separate
send_emails.pyscript with SendGrid. - The README notes that search currently iterates through the database.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up a local Arxiv Sanity Lite instance
Install the documented Python requirements, update the paper database, compute features, and start the Flask server.
Before you start
- Python 3
- The project's repository and requirements file
- Access to the arXiv API for retrieving new papers
Steps
Install dependencies with the command below.
pip install -r requirements.txtRun the command below to retrieve new papers.
python3 arxiv_daemon.py --num 2000If new papers were added, run the command below to compute TF-IDF features.
python3 compute.pySet
FLASK_APP=serve.pyand runflask runto serve the application locally.
Expected outcome
A locally served Flask application with its database stored in the `data` directory.
Guide limitations
- The documented retrieval workflow targets arXiv; using another source requires adapting retrieval and data handling.
- The README says search iterates through the database, which may affect performance as collections grow.
Configure scheduled recommendation emails
Add the documented email-sending stage for periodic recommendations based on users' tags.
Before you start
- An installed Arxiv Sanity Lite instance
- The SendGrid package, installed with
pip install sendgrid
Steps
Install SendGrid with the command below.
pip install sendgridUse the project's
send_emails.pyscript to send recommendations.Schedule the script periodically; the README describes running it as a daily cron job.
Expected outcome
A scheduled email stage for new-paper recommendations based on tags.
Guide limitations
- The README does not detail email-provider account setup or configuration.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 15 October 2026
- Original website title
- karpathy/arxiv-sanity-lite · Official homepage title · retained in its source language

