daily-arXiv-ai-enhanced

Automatically fetches the latest research papers from arXiv on a daily schedule using GitHub Actions, filtering by user-specified categories (e.g., cs.AI, cs.LG, cs.CL). The system queries arXiv's API with category-based search queries, extracts metadata (paper ID, title, authors, abstract, publication date), and stores raw results in JSONL format. Implements retry logic and rate-limiting to respect arXiv's API constraints while ensuring reliable daily collection.

Processes raw arXiv paper abstracts through an LLM (OpenAI GPT-4/3.5 or compatible API) to generate structured summaries with discrete fields: TLDR (one-liner), motivation, methodology, results, and conclusion. Uses prompt engineering with few-shot examples to ensure consistent JSON output structure. Implements batching and error handling to manage API costs and handle rate limits, storing enhanced results in JSONL format with original metadata preserved.

Parses arXiv API responses to extract and normalize paper metadata including arxiv_id, title, authors (as list), abstract, categories, published_date, and pdf_url. Handles variations in arXiv's response format (e.g., multiple author formats, category encoding) and normalizes data into consistent JSONL schema. Implements validation to ensure all required fields are present and correctly formatted, discarding malformed records. Preserves original metadata without modification, enabling downstream processing to add enhancements while maintaining data integrity.

Generates paper summaries in multiple languages (primarily Chinese and English) by using language-specific prompt templates that instruct the LLM to produce output in the target language. The system maintains separate JSONL files per language (e.g., data/2025-06-09_AI_enhanced_Chinese.jsonl) and uses configurable language codes to control output. Implements language selection via repository variables, allowing users to customize which languages are generated without code changes.

Transforms JSONL files (raw and AI-enhanced) into human-readable markdown files organized by arXiv categories, with each paper rendered as a collapsible HTML details element. The conversion process reads JSONL records, groups papers by category, applies a markdown template (template.md) to format each paper's metadata and summary, and generates a single markdown file per day with a table of contents. Uses HTML details/summary tags for collapsible sections, enabling readers to expand papers of interest without scrolling through full content.

Implements the entire pipeline (crawl → enhance → convert) as a GitHub Actions workflow (.github/workflows/run.yml) triggered on a daily schedule using cron syntax. The workflow runs in a containerized environment, executes shell scripts (run.sh) to invoke Python/Node.js processing steps, and commits results back to the repository. Configuration is managed through GitHub repository secrets (API keys) and variables (categories, languages, models), enabling users to customize behavior without forking or modifying code.

Allows users to specify which arXiv categories to crawl through repository variables (e.g., ARXIV_CATEGORIES='cs.AI,cs.LG,cs.CL'). The system parses the category list and constructs arXiv API queries that fetch papers from all specified categories in a single daily run. Supports both single-category and multi-category configurations, enabling users to create custom paper collections without code changes. Categories are stored as comma-separated strings in repository variables, making them easily editable via GitHub UI.

Automatically organizes all crawled and enhanced papers into date-stamped files (data/YYYY-MM-DD.jsonl, data/YYYY-MM-DD_AI_enhanced_LANGUAGE.jsonl, data/YYYY-MM-DD.md) committed to the repository. Each day's run creates a new set of files, creating a historical archive of papers and summaries. The system preserves all previous days' data, enabling users to browse historical digests and track how paper topics evolve over time. Files are committed to git with descriptive messages, maintaining full version history.

Uses a configurable markdown template (template.md) to define how each paper is rendered in the final markdown output. The template contains placeholder variables (e.g., {{title}}, {{authors}}, {{tldr}}, {{method}}) that are replaced with actual paper data during conversion. Users can customize the template to change paper layout, add custom fields, or modify formatting without changing the core pipeline. The system applies the template to each paper record, enabling consistent formatting across all papers.

Automatically publishes generated markdown files to GitHub Pages by committing them to the repository, enabling public browsing of paper digests without additional hosting infrastructure. The system commits markdown files to the data/ directory, which GitHub Pages serves as static content. Users can access papers via a simple URL (e.g., arxiv.dw-dengwei.cn) pointing to the GitHub Pages site. No backend server or database required — all content is static markdown rendered by GitHub's built-in markdown viewer.

Processes multiple papers in batches when calling the LLM API, grouping requests to reduce overhead and manage costs. The system accumulates paper records and sends them to the LLM in batches (e.g., 10 papers per batch) rather than one-at-a-time, reducing the number of API calls and associated costs. Implements error handling for partial batch failures, allowing the system to retry failed papers without re-processing successful ones. Tracks API usage and costs, enabling users to monitor spending.