mirror of
https://github.com/kennethreitz/kjvstudy.org.git
synced 2026-06-05 23:00:16 +00:00
kennethreitz
f4c2b70f6e
Streamlined structure, added AI commentary, Strong's Concordance details, family tree explorer, PDF export, accessibility features, and API docs. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
212 lines
5.1 KiB
Markdown
212 lines
5.1 KiB
Markdown
# 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](https://kjvstudy.org)
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
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
|
|
|
|
**Interlinear Bible**
|
|
- 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
|
|
|
|
**Strong's Concordance**
|
|
- 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:**
|
|
- The Gospel Message
|
|
- Salvation by Grace
|
|
- New Believer's Guide
|
|
- Prayer and Faith
|
|
- Christian Living
|
|
- Hope and Comfort
|
|
- Wisdom and Guidance
|
|
|
|
**Reading Plans:**
|
|
- One-Year Bible
|
|
- 90-Day New Testament
|
|
- Chronological Reading
|
|
- Gospels and Acts (30 days)
|
|
- Psalms and Proverbs
|
|
- And more
|
|
|
|
### 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 at `/api/docs`.
|
|
|
|
**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)
|
|
```bash
|
|
docker compose up
|
|
```
|
|
|
|
### Without Docker
|
|
```bash
|
|
# Requires Python 3.13+ and uv
|
|
uv sync
|
|
uv run kjvstudy-org
|
|
```
|
|
|
|
### Running Tests
|
|
```bash
|
|
uv run pytest tests/ -v
|
|
```
|
|
|
|
100 tests covering API endpoints, edge cases, and web routes.
|
|
|
|
---
|
|
|
|
## Deployment
|
|
|
|
Optimized for Fly.io:
|
|
|
|
```bash
|
|
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](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
|