# birdger/daily-arxiv-digest architecture

> Architecture diagram of the GitHub repository birdger/daily-arxiv-digest, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/birdger/daily-arxiv-digest
- Repository: https://github.com/birdger/daily-arxiv-digest

## Overview

This repository is a scheduled arXiv paper digest generator. GitHub Actions starts the script, which loads user-defined filters, fetches papers from RSS (falling back to the arXiv API), scores and filters them, then writes a Chinese Markdown digest and refreshes the README index. The script excerpt supports the configuration, retrieval, parsing, and scoring relationships; output and scheduling links are documented in the README. The workflow file itself was not sampled.

Main entry points: [`scripts/daily_digest.py`](https://github.com/birdger/daily-arxiv-digest/blob/main/scripts/daily_digest.py) (Digest runner), [`.github/workflows/daily.yml`](https://github.com/birdger/daily-arxiv-digest/blob/main/.github/workflows/daily.yml) (GitHub Actions), [`config.json`](https://github.com/birdger/daily-arxiv-digest/blob/main/config.json) (Digest settings), [`digests`](https://github.com/birdger/daily-arxiv-digest/tree/main/digests) (Daily Markdown)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_automation["Automation"]
  node_schedule(("Daily trigger"))
  node_actions["GitHub Actions<br/>[daily.yml]"]
end

subgraph group_pipeline["Digest pipeline"]
  node_runner["Digest runner<br/>[daily_digest.py]"]
  node_settings["Digest settings<br/>[config.json]"]
  node_retrieval["Paper retrieval<br/>[daily_digest.py]"]
  node_ranking["Scoring and filtering<br/>[daily_digest.py]"]
end

subgraph group_outputs["Published digests"]
  node_digest["Daily Markdown"]
  node_index["README index<br/>[README.md]"]
end

node_arxiv["arXiv feeds"]

node_schedule -.->|"triggers"| node_actions
node_actions -.->|"runs daily"| node_runner
node_runner -->|"loads config"| node_settings
node_runner -->|"collects papers"| node_retrieval
node_retrieval -->|"fetches RSS/API"| node_arxiv
node_runner -->|"scores papers"| node_ranking
node_runner -.->|"writes digest"| node_digest
node_runner -->|"updates index"| node_index

click node_actions "https://github.com/birdger/daily-arxiv-digest/blob/main/.github/workflows/daily.yml"
click node_runner "https://github.com/birdger/daily-arxiv-digest/blob/main/scripts/daily_digest.py"
click node_settings "https://github.com/birdger/daily-arxiv-digest/blob/main/config.json"
click node_retrieval "https://github.com/birdger/daily-arxiv-digest/blob/main/scripts/daily_digest.py"
click node_ranking "https://github.com/birdger/daily-arxiv-digest/blob/main/scripts/daily_digest.py"
click node_digest "https://github.com/birdger/daily-arxiv-digest/tree/main/digests"
click node_index "https://github.com/birdger/daily-arxiv-digest/blob/main/README.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_schedule,node_actions toneBlue
class node_runner,node_settings,node_retrieval,node_ranking toneAmber
class node_digest,node_index toneMint
class node_arxiv toneIndigo
```

## Components

### Automation

- **Daily trigger**
- [GitHub Actions](https://github.com/birdger/daily-arxiv-digest/blob/main/.github/workflows/daily.yml): `.github/workflows/daily.yml`

### Digest pipeline

- [Digest runner](https://github.com/birdger/daily-arxiv-digest/blob/main/scripts/daily_digest.py): `scripts/daily_digest.py`
- [Digest settings](https://github.com/birdger/daily-arxiv-digest/blob/main/config.json): `config.json`
- [Paper retrieval](https://github.com/birdger/daily-arxiv-digest/blob/main/scripts/daily_digest.py): `scripts/daily_digest.py`
- [Scoring and filtering](https://github.com/birdger/daily-arxiv-digest/blob/main/scripts/daily_digest.py): `scripts/daily_digest.py`

### Published digests

- [Daily Markdown](https://github.com/birdger/daily-arxiv-digest/tree/main/digests): `digests`
- [README index](https://github.com/birdger/daily-arxiv-digest/blob/main/README.md): `README.md`

### Other components

- **arXiv feeds**

## Connections

- Daily trigger → GitHub Actions: triggers (evidence: `README.md`)
- GitHub Actions → Digest runner: runs daily (evidence: `README.md`)
- Digest runner → Digest settings: loads config (evidence: `scripts/daily_digest.py`)
- Digest runner → Paper retrieval: collects papers (evidence: `scripts/daily_digest.py`)
- Paper retrieval → arXiv feeds: fetches RSS/API (evidence: `scripts/daily_digest.py`)
- Digest runner → Scoring and filtering: scores papers (evidence: `scripts/daily_digest.py`)
- Digest runner → Daily Markdown: writes digest (evidence: `README.md`)
- Digest runner → README index: updates index (evidence: `scripts/daily_digest.py`)
