How gavin-edgley/booksummarizer works
BookSummarizer is an interactive CLI that takes a text or EPUB book, plans a summary for a chosen reading time, calls Claude to produce it, and saves the summary and original. Its documented workflow also includes cost estimation, splitting large books, and resuming interrupted work. The source excerpt confirms API requests and temporary progress files; relationships for other stages are based on README workflow descriptions, since their implementation was not shown.
Main entry points: summarize.py CLI Orchestrator · BooksOut Completed Books · BooksIn Book Input · Temp Progress Files
Components 17
Book Workflow
- CLI Orchestrator
summarize.py - Book Selection
summarize.py - Summary Planning
summarize.py - Resume Handling
summarize.py
Summary Processing
- Format Handling
summarize.py - Reading Estimate
summarize.py - Cost Estimate
summarize.py - Document Splitting
summarize.py - Prompt Generation
summarize.py - Summary Output
summarize.py - EPUB Export
summarize.py
Files and Recovery
- Book Input
BooksIn - Completed Books
BooksOut - Progress Files
Temp
External Services
- Claude API
- Pandoc
Other components
- User
Connections 18
- User → CLI Orchestrator: runs or configures
README.md - CLI Orchestrator → Book Selection: starts selection
README.md - Book Selection → Book Input: lists books
README.md - Book Selection → Format Handling: passes selected file
README.md - Format Handling → Pandoc: converts EPUB
summarize.py - Format Handling → Reading Estimate: provides text
summarize.py - Reading Estimate → Summary Planning: informs target
README.md - CLI Orchestrator → Cost Estimate: estimates cost
README.md - Summary Planning → Document Splitting: chooses split strategy
README.md - Document Splitting → Prompt Generation: supplies text parts
summarize.py - Prompt Generation → Claude API: requests summary
summarize.py - CLI Orchestrator → Resume Handling: checks interrupted jobs
README.md - Resume Handling → Progress Files: reads or writes progress
summarize.py - Claude API → Summary Output: returns generated text
- Summary Output → Completed Books: saves summary and original
README.md - Summary Output → EPUB Export: exports EPUB
README.md - EPUB Export → Pandoc: converts summary
README.md - EPUB Export → Completed Books: saves EPUB
README.md