How tidedra/zotero-arxiv-daily works
Zotero-arXiv-Daily fetches a user’s Zotero library and recent preprints, ranks candidates against the library, enriches selected papers, then emails a daily digest. The README documents four sources, local or API-based reranking, LLM summaries and affiliations, and PDF/code links. The graph follows the executor as the orchestrator; some feature links are documented in the README but their implementation was not sampled.
Main entry points: executor.py Workflow executor · retriever/base.py Retriever framework · arxiv_retriever.py arXiv retrieval · reranker/base.py Relevance scoring
Components 24
Workflow and delivery
- Application entry
src/zotero_arxiv_daily/main.py - Workflow executor
src/zotero_arxiv_daily/executor.py - Digest rendering
src/zotero_arxiv_daily/construct_email.py - SMTP delivery
src/zotero_arxiv_daily/utils.py - Runtime configuration
config/default.yaml
Zotero interest model
- Zotero library
- Library corpus
src/zotero_arxiv_daily/protocol.py - Collection filtering
src/zotero_arxiv_daily/executor.py
Preprint sources
- arXiv retrieval
src/zotero_arxiv_daily/retriever/arxiv_retriever.py - bioRxiv retrieval
src/zotero_arxiv_daily/retriever/biorxiv_retriever.py - medRxiv retrieval
src/zotero_arxiv_daily/retriever/medrxiv_retriever.py - chemRxiv retrieval
src/zotero_arxiv_daily/retriever/chemrxiv_retriever.py - Retriever framework
src/zotero_arxiv_daily/retriever/base.py
Relevance ranking
- Relevance scoring
src/zotero_arxiv_daily/reranker/base.py - Local embeddings
src/zotero_arxiv_daily/reranker/local.py - Embedding API
src/zotero_arxiv_daily/reranker/api.py
Paper enrichment
- Paper records
src/zotero_arxiv_daily/protocol.py - LLM enrichment
src/zotero_arxiv_daily/protocol.py - PDF and TeX extraction
src/zotero_arxiv_daily/utils.py
Other components
- Scheduled run
- Mailbox recipient
- LLM service
- Preprint services
- Embedding service
Connections 26
- Scheduled run → Application entry: starts
README.md - Application entry → Workflow executor: runs
src/zotero_arxiv_daily/main.py - Runtime configuration → Workflow executor: configures
README.md - Workflow executor → Zotero library: fetches library
src/zotero_arxiv_daily/executor.py - Workflow executor → Collection filtering: filters corpus
src/zotero_arxiv_daily/executor.py - Workflow executor → Library corpus: builds corpus
src/zotero_arxiv_daily/executor.py - Workflow executor → Retriever framework: selects retrievers
src/zotero_arxiv_daily/executor.py - Retriever framework → arXiv retrieval: registers
src/zotero_arxiv_daily/retriever/__init__.py - Retriever framework → bioRxiv retrieval: registers
src/zotero_arxiv_daily/retriever/__init__.py - Retriever framework → medRxiv retrieval: registers
src/zotero_arxiv_daily/retriever/__init__.py - Retriever framework → chemRxiv retrieval: registers
src/zotero_arxiv_daily/retriever/__init__.py - arXiv retrieval → Preprint services: queries
src/zotero_arxiv_daily/retriever/arxiv_retriever.py - bioRxiv retrieval → Preprint services: queries
src/zotero_arxiv_daily/retriever/biorxiv_retriever.py - chemRxiv retrieval → Preprint services: queries Crossref
src/zotero_arxiv_daily/retriever/chemrxiv_retriever.py - Workflow executor → Relevance scoring: reranks papers
src/zotero_arxiv_daily/executor.py - Relevance scoring → Local embeddings: uses scorer
src/zotero_arxiv_daily/reranker/base.py - Relevance scoring → Embedding API: uses scorer
src/zotero_arxiv_daily/reranker/base.py - Embedding API → Embedding service: requests embeddings
src/zotero_arxiv_daily/reranker/api.py - Workflow executor → LLM enrichment: enriches selected papers
src/zotero_arxiv_daily/executor.py - LLM enrichment → LLM service: requests summaries and affiliations
src/zotero_arxiv_daily/protocol.py - arXiv retrieval → PDF and TeX extraction: extracts text
src/zotero_arxiv_daily/retriever/arxiv_retriever.py - Workflow executor → Digest rendering: renders digest
src/zotero_arxiv_daily/executor.py - Workflow executor → SMTP delivery: sends digest
src/zotero_arxiv_daily/executor.py - SMTP delivery → Mailbox recipient: delivers email
src/zotero_arxiv_daily/utils.py - Digest rendering → Paper records: formats paper details
README.md - Paper records → Mailbox recipient: provides PDF and code links
README.md