mirror of
https://github.com/kennethreitz/kjvstudy.org.git
synced 2026-06-05 23:00:16 +00:00
kennethreitz
f39e71472f
Major performance improvements:
1. Build book/chapter indexes at Bible init for O(1) lookups instead of
O(n) iteration through 31,102 verses on every API request
2. Pre-compute total word count at init instead of splitting all verse
text on every /stats or /about request
3. Add get_verses_by_book() and get_total_words() methods to Bible class
4. Replace all iter_verses()/iter_chapters() calls in API routes with
indexed get_verses_by_book_chapter() and get_chapters_for_book()
5. Remove unused Scofield commentary load at startup (27KB saved)
6. Increase GZip minimum_size from 500 to 1000 bytes to reduce CPU
waste on tiny responses
Affected endpoints (now O(1) instead of O(n)):
- GET /api/books, /api/books/{book}, /api/books/{book}/text
- GET /api/books/{book}/pdf, /api/books/{book}/chapters/{chapter}
- GET /api/bible, /api/stats, /about/stats
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
KJV Study
A comprehensive web application for deep study of the King James Bible, featuring original language tools, AI-powered commentary, extensive theological resources, and classical scholarly presentation.
Live Site: kjvstudy.org
Quick Start
git clone https://github.com/kennethreitz/kjvstudy.org.git
cd kjvstudy.org
docker compose up
Open http://localhost:8000 and start studying.
Features
Complete Bible Text
- 31,102 verses from the 1769 Cambridge KJV edition
- Full-text search with concordance functionality
- Cross-references throughout Scripture
- Verse of the Day and Random Verse discovery
- Red Letter edition tracking words of Christ
Original Language Tools
- Complete Greek (NT) and Hebrew (OT) word-by-word analysis
- Morphological tagging and grammatical parsing
- Root word exploration and etymology
- Word occurrence tracking across the entire Bible
- 8,674 Hebrew entries (H1-H8674)
- 5,624 Greek entries (G1-G5624)
- Definitions, transliterations, pronunciation guides
- Searchable by word, definition, or Strong's number
- Related word derivations and cross-references
AI-Powered Commentary
- Verse-by-verse theological analysis
- Chapter overviews and book summaries
- Historical and cultural context
- Reflection questions for personal study
- Word studies for key biblical terms
Study Resources
39+ Resource Categories:
| Category | Examples |
|---|---|
| Biblical People | Twelve Apostles, Women of the Bible, Prophets, Angels |
| Systematic Theology | Christology, Soteriology, Eschatology, Pneumatology |
| Biblical Themes | Parables, Covenants, Names of God, Fruits of the Spirit |
| Historical Context | Timeline, Maps, Festivals, Family Trees |
Study Guides:
Reading Plans:
Family Tree Explorer
- 429+ biblical figures with genealogical data
- 77+ generations from Adam through the New Testament
- Interactive ancestor/descendant navigation
- Biographical data and related Scripture references
- GEDCOM-based data with Kekule numbering
PDF Export
Generate downloadable PDFs for:
- Individual verses, chapters, or entire books
- Study guides and topical collections
- Bible stories (including children's versions)
- Reading plans and resources
Accessibility
- Full keyboard navigation (Vim-style and arrow keys)
- Screen reader support with semantic HTML
- Text-to-speech for Scripture reading
- Dark mode with system preference detection
- Adjustable font sizes
Tech Stack
| Layer | Technology |
|---|---|
| Backend | FastAPI, Python 3.13 |
| Frontend | Tufte CSS, Vanilla JavaScript |
| Data | JSON (Bible text), SQLite (search index), Gzip (interlinear) |
| Infrastructure | Docker, Fly.io |
| Package Management | uv |
API
Full RESTful API with OpenAPI documentation.
Key Endpoints:
GET /api/verse/{book}/{chapter}/{verse}
GET /api/books/{book}/chapters/{chapter}
GET /api/search?q={query}
GET /api/interlinear/{book}/{chapter}/{verse}
GET /api/strongs/{number}
GET /api/cross-references/{book}/{chapter}/{verse}
GET /api/topics/{topic}
GET /api/reading-plans/{plan}
Development
With Docker (Recommended)
docker compose up
Without Docker
# Requires Python 3.13+ and uv
uv sync
uv run kjvstudy-org
Running Tests
uv run pytest tests/ -v
100 tests covering API endpoints, edge cases, and web routes.
Deployment
Optimized for Fly.io:
fly deploy
Configuration includes:
- 2GB RAM with shared CPU
- Always-on (no cold starts)
- Preloaded interlinear data
- Health checks and auto-recovery
Project Structure
kjvstudy.org/
├── kjvstudy_org/
│ ├── server.py # FastAPI application
│ ├── kjv.py # Bible text access (31,102 verses)
│ ├── interlinear_loader.py
│ ├── strongs_loader.py
│ ├── cross_references.py
│ ├── topics.py
│ ├── reading_plans.py
│ ├── routes/ # API and web routes
│ ├── templates/ # Jinja2 templates
│ ├── static/ # CSS, JS, images
│ └── data/ # JSON data files
├── tests/ # Test suite
├── Dockerfile
├── fly.toml
└── pyproject.toml
Contributing
Contributions welcome in:
- Development: Backend features, frontend improvements, API extensions
- Content: Theological review, study guides, original language expertise
- Design: Accessibility, mobile experience, print stylesheets
- Documentation: Tutorials, API docs, translations
License
ISC License. See LICENSE.
"Study to shew thyself approved unto God, a workman that needeth not to be ashamed, rightly dividing the word of truth." — 2 Timothy 2:15