mirror of
https://github.com/kennethreitz/kjvstudy.org.git
synced 2026-06-05 23:00:16 +00:00
kennethreitz
5c4417b27f
Psalms: - Ps 18: [7,17,28,43] → [7,20,28,43] - righteousness theme starts v20 - Ps 68: [7,14,20,27,33] → [7,15,21,28,32] - multiple section fixes - Ps 69: [5,14,22,30] → [6,14,22,30] - suffering for God starts v6 - Ps 89: [5,15,19,39,47] → [5,15,19,38,46] - lament v38, plea v46 - Ps 104: [9,18,27,32] → [10,19,27,33] - springs v10, sun/moon v19 Prophets: - Isaiah 9: [5,8,13,17,21] → [6,8,13,17] - "child is born" v6 - Isaiah 11: [5,9,12,16] → [6,10,13] - peaceable kingdom v6 - Hosea 11: [5,9,12] → [5,8,10] - "How shall I give thee up" v8 - Zechariah 9: [8,13,17] → [9,13] - Messianic "Rejoice greatly" v9 - Zephaniah 3: [7,13,17,20] → [8,14,18] - "Sing, O daughter" v14 - Nahum 1: [6,11,15] → [7,11,15] - "LORD is good" v7 - Malachi 3: [6,12,18] → [7,13] - tithing section v7 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <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