Skip to content

Repository files navigation

Weekly Cryptography Digest

Turn newly published cryptography research into a concise, ranked weekly reading list.

Tests Python 3.10+ MIT License

Weekly Cryptography Digest is a small, auditable Python pipeline for researchers and engineers. It collects recent papers from arXiv and IACR ePrint, groups them by topic, ranks them against your interests, and writes a Markdown digest for human review.

It is deliberately local-first: nothing is emailed, posted, committed, pushed, or published automatically.

Highlights

  • Collects recent research from arXiv cs.CR and the IACR Cryptology ePrint Archive.
  • Groups papers into zero knowledge, post-quantum cryptography, MPC/FHE, cryptanalysis, protocols/privacy, and foundations.
  • Ranks results using configurable topic priorities, interest phrases, recency, and explicit result language.
  • Extracts a compact highlight from each abstract.
  • Produces readable Markdown and machine-friendly JSON drafts.
  • Keeps generated drafts out of Git by default.

Quick start

Python 3.10 or newer is required.

git clone https://github.com/MAGNC/weekly-cryptography-digest.git
cd weekly-cryptography-digest
python -m venv .venv
python -m pip install -e .

Create your local configuration:

# macOS / Linux
cp config.example.json config.json

# Windows PowerShell
Copy-Item config.example.json config.json

Prepare a digest:

crypto-digest --config config.json

Drafts appear in:

digests/drafts/YYYY-MM-DD.md
digests/drafts/YYYY-MM-DD.json

Customize relevance

Edit config.json to tune:

  • interests — phrases that increase a paper's relevance score.
  • topic_priorities — weights for the topics you care about most.
  • lookback_days — how far back each run searches.
  • max_papers and max_highlights — digest length.
  • Source toggles and the arXiv result limit.

The ranking formula is intentionally transparent:

score = 2 * topic priority + 1.5 * matched interests + recency + result-language bonus

Safe weekly automation

Run the CLI with a local scheduler or a Codex recurring automation. A scheduled job should only:

  1. Run crypto-digest --config config.json.
  2. Confirm that new files exist under digests/drafts/.
  3. Report the local Markdown path for review.

There is intentionally no scheduled GitHub Action. CI only runs tests on pushes and pull requests; generated research digests remain private unless you choose to share them.

Development

python -m pip install -e .
python -m unittest discover -s tests -v
crypto-digest --fixture-dir tests/fixtures --days 365

Feed metadata and keyword classification can be incomplete. Always verify important claims in the linked papers.

License

Released under the MIT License. Contributions are welcome; see CONTRIBUTING.md and SECURITY.md.

About

A local-first pipeline that turns new cryptography papers into a ranked weekly digest.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages