arxiv-reader

Quick Start

1. Configuration .env

cp .env.example .env   # 或直接编辑 .env

Make sure you have configured:

• LLM_API_KEY — Key for OpenAI or a compatible API
• LLM_BASE_URL — API address

2. Run

uv venv
uv pip install -r "{baseDir}/requirements.txt"

Single-paper mode: specify an arxiv_id or URL

uv run python "{baseDir}/main.py" --arxiv-id 2401.12345 uv run python "{baseDir}/main.py" --arxiv-id https://arxiv.org/abs/2401.12345 uv run python "{baseDir}/main.py" --arxiv-id https://arxiv.org/pdf/2401.12345.pdf

Specify reading under a particular category

uv run python "{baseDir}/main.py" --arxiv-id xxxx --category yyy

View all categories

uv run python "{baseDir}/main.py" --list

## 添加新的阅读分类

在 `skills/` 下新建文件夹，包含两个文件：

skills/your_new_category/ ├── _metadata.md # Category description (tells the Classifier which papers belong to this category) └── reading_prompt.md # Reading guide (tells the Reader Agent what to focus on)

重启即可自动识别，无需修改任何代码。

## Python包

- LangChain 1.x — Agent 框架（基于 LangGraph）
- LangChain OpenAI — LLM 接口（兼容 DeepSeek 等 OpenAI-compatible API）
- arxiv — 官方 Python 库
- arxiv-to-prompt 获取arxiv论文latex源码