An automatically-updated EPUB of every essay from paulgraham.com/articles.html.
The latest build is always attached to the
Releases page as
paul_graham_essays.epub.
- 232 essays, each as its own chapter with a proper table-of-contents entry, so you can jump straight to any essay.
- Essays appear in the same order as the site (newest first).
A GitHub Actions workflow (.github/workflows/update-epub.yml) runs every 15
days:
- Fetches the essay index from paulgraham.com.
- Compares it against the tracker (
state.json) and downloads only new or changed essays. - Rebuilds the EPUB.
- Commits the essay changes and attaches the EPUB to a new GitHub Release
(tagged by date, e.g.
v2026.08.25). Same-day reruns refresh the asset.
You can also trigger it manually from the Actions tab (the "Run workflow" button). The EPUB itself is not committed to git — it's a build artifact that lives on the Releases page.
python3 -m pip install -r requirements.txt
python3 build_epub.pyThe script is idempotent: re-running it only downloads new essays and rebuilds the EPUB.
├── build_epub.py # fetches, extracts, tracks, and builds the EPUB
├── state.json # tracker of already-downloaded essays (href + hash)
├── essays/ # extracted essay bodies (one .html per essay)
├── requirements.txt # pinned Python deps (ebooklib)
├── paul_graham_essays.epub # build artifact — attached to Releases, gitignored
└── .github/workflows/ # the scheduled update workflow