Skip to main content

Tracking daily arXiv updates and generating intelligent summaries with LLMs.

Project description

arxiv-daily

PyPI version Python Version License

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 --help for an overview, or arXiv <command> --help for 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:

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

arxiv_daily-0.1.2.tar.gz (161.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

arxiv_daily-0.1.2-py3-none-any.whl (18.2 kB view details)

Uploaded Python 3

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

Hashes for arxiv_daily-0.1.2.tar.gz
Algorithm Hash digest
SHA256 7efaafa65123f44cc033acced5d3c69b3a20f023f43b62b9add89a3b928dcd93
MD5 f780bc38381860288605999aa0f3f0e8
BLAKE2b-256 2f5edd4b965e4399a899c8b64f4c3da32ff3b86b8ab234e50c3b1ec4d56acab5

See more details on using hashes here.

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

Hashes for arxiv_daily-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 4bbc2568a2f310c1b1b50978245464345bf148342f9b6b3c937b3f068388fff6
MD5 21f6587e5d624aee1c5d242a41ca6f7c
BLAKE2b-256 c79a84603bb659a09d6adcd0ab76c415a56112ed54c33bcb66c0ee45f79ab543

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page