Tracking daily arXiv updates and generating intelligent summaries with LLMs.
Project description
arxiv-daily
AI-powered arXiv research assistant - Beautiful terminal interface for tracking arXiv preprints and generating intelligent summaries with LLMs.
Key capabilities:
- Daily arXiv Updates: Fetch and filter the latest preprints from any arXiv channel.
- AI-Powered Summaries: Generate structured, organized summaries using LLMs.
- Beautiful Output: Colorful terminal output, syntax highlighting, and progress bars using the Rich library.
- Smart Filtering: Filter by arXiv categories and channels for focused research.
Quick Start
Install
Install the package from PyPI:
pip install arxiv-daily
Or install from source for development:
git clone https://github.com/GZU-MuTian/arxiv-daily.git
cd arxiv-daily
pip install -e .
Environment Setup (Recommended)
To streamline usage and avoid repetitive CLI flags, we recommend configuring environment variables. This approach simplifies command execution and enhances security by avoiding credentials in command history.
# LLM Configuration (required)
DEEPSEEK_API_KEY="your-deepseek-api-key-here"
# Default arXiv categories (comma-separated)
export ARXIV_CATEGORY="cs.AI,astro-ph.HE,hep-ph"
Usage Guide
Command-Line Interface
arxiv-daily includes a CLI named arXiv.
🔧 Tip: Run
arXiv --helpfor an overview, orarXiv <command> --helpfor command-specific options.
Fetch the latest preprints from any arXiv channel with beautiful terminal formatting:
# Get the latest papers in Astrophysics
arXiv new
# Specific channel (e.g., Computer Science - AI)
arXiv new --channel cs.AI
# Filter by multiple categories
arXiv new --channel astro-ph --category astro-ph.HE,astro-ph.IM
Generate AI Summaries:
# Basic summary with default model (DeepSeek)
arXiv summarize <arxiv_id>
# Specify model and provider
arXiv summarize <arxiv_id> --model deepseek-chat --provider deepseek
# Short form
arXiv summarize <arxiv_id> -m deepseek-chat -p deepseek -t 0.5
Adjust verbosity for debugging or quiet runs:
# Production - errors only (default)
arXiv --log-level ERROR new
# Short form for detailed debugging
arXiv -v DEBUG new
Project Structure
arxiv_daily/
├── agents.py # LangGraph agents for complex summarization workflows
├── chains.py # LangChain chains for LLM interactions
├── cli.py # Command-line interface built with Typer
├── core.py # Core functions (_run_new, _run_summarize)
├── llm_client.py # Unified LLM provider interface
├── utils.py # Utility functions
└── __init__.py
Related Resources
Contact
For questions and support:
- Author: Yu Liu
- Email: yuliu@gzu.edu.cn
- GitHub Issues: Report bugs or request features
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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file arxiv_daily-0.1.2.tar.gz.
File metadata
- Download URL: arxiv_daily-0.1.2.tar.gz
- Upload date:
- Size: 161.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.11 {"installer":{"name":"uv","version":"0.9.11"},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7efaafa65123f44cc033acced5d3c69b3a20f023f43b62b9add89a3b928dcd93
|
|
| MD5 |
f780bc38381860288605999aa0f3f0e8
|
|
| BLAKE2b-256 |
2f5edd4b965e4399a899c8b64f4c3da32ff3b86b8ab234e50c3b1ec4d56acab5
|
File details
Details for the file arxiv_daily-0.1.2-py3-none-any.whl.
File metadata
- Download URL: arxiv_daily-0.1.2-py3-none-any.whl
- Upload date:
- Size: 18.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.11 {"installer":{"name":"uv","version":"0.9.11"},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4bbc2568a2f310c1b1b50978245464345bf148342f9b6b3c937b3f068388fff6
|
|
| MD5 |
21f6587e5d624aee1c5d242a41ca6f7c
|
|
| BLAKE2b-256 |
c79a84603bb659a09d6adcd0ab76c415a56112ed54c33bcb66c0ee45f79ab543
|