kjvstudy.org/README.md

# KJV Study

A scholarly web application for deep study of the King James Bible — pairing the 1769 Cambridge text with original language tools, AI-powered commentary, and classical typography inspired by Edward Tufte.

**[kjvstudy.org](https://kjvstudy.org)**

---

## Overview

KJV Study provides the complete King James Bible (31,102 verses) alongside an extensive suite of research tools: interlinear Hebrew and Greek analysis, Strong's Concordance, cross-references, topical indexes, genealogies, reading plans, and verse-by-verse AI commentary. The entire application is served as a fast, accessible web experience with a full REST API.

```bash
git clone https://github.com/kennethreitz/kjvstudy.org.git
cd kjvstudy.org
docker compose up
# → http://localhost:8000
```

---

## Features

### Scripture

- **31,102 verses** from the 1769 Cambridge KJV edition — [browse all 66 books](https://kjvstudy.org/books)
- [Full-text search](https://kjvstudy.org/search) with SQLite-backed concordance
- [Cross-references](https://kjvstudy.org/book/John/chapter/3/verse/16) throughout Scripture
- [Red Letter edition](https://kjvstudy.org/red-letter) highlighting the words of Christ
- [Verse of the Day](https://kjvstudy.org/verse-of-the-day) and [Random Verse](https://kjvstudy.org/random-verse)

### Original Languages

- **[Interlinear Bible](https://kjvstudy.org/interlinear)** — word-by-word Greek (NT) and Hebrew (OT) with morphological tagging, grammatical parsing, root word exploration, and occurrence tracking
- **[Strong's Concordance](https://kjvstudy.org/strongs)** — [8,674 Hebrew](https://kjvstudy.org/strongs/hebrew) and [5,624 Greek](https://kjvstudy.org/strongs/greek) entries with definitions, transliterations, pronunciation, and derivations

### Commentary

AI-powered [verse-by-verse theological analysis](https://kjvstudy.org/book/John/chapter/3/verse/16) with chapter overviews, book summaries, historical context, word studies, and reflection questions — generated for all 66 books.

### Study Resources

| | |
|---|---|
| **Theology** | [Christology](https://kjvstudy.org/christology), [Soteriology](https://kjvstudy.org/soteriology), [Eschatology](https://kjvstudy.org/eschatology), [Pneumatology](https://kjvstudy.org/pneumatology) |
| **People** | [Twelve Apostles](https://kjvstudy.org/the-twelve-apostles), [Women of the Bible](https://kjvstudy.org/women-of-the-bible), [Prophets](https://kjvstudy.org/biblical-prophets), [Angels](https://kjvstudy.org/biblical-angels) |
| **Themes** | [Parables](https://kjvstudy.org/parables), [Covenants](https://kjvstudy.org/biblical-covenants), [Names of God](https://kjvstudy.org/names-of-god), [Fruits of the Spirit](https://kjvstudy.org/fruits-of-the-spirit) |
| **History** | [Timeline](https://kjvstudy.org/biblical-timeline), [Maps](https://kjvstudy.org/biblical-maps), [Festivals](https://kjvstudy.org/biblical-festivals) |
| **Guides** | [Gospel](https://kjvstudy.org/study-guides/gospel), [Salvation](https://kjvstudy.org/study-guides/salvation), [New Believer](https://kjvstudy.org/study-guides/new-believer), [Prayer & Faith](https://kjvstudy.org/study-guides/prayer-faith), &c. |
| **Plans** | [One-Year Bible](https://kjvstudy.org/reading-plans/one-year), [90-Day NT](https://kjvstudy.org/reading-plans/90-day-nt), [Chronological](https://kjvstudy.org/reading-plans/chronological), &c. |

39 resource categories, 36 study guides, 36 topical indexes, 12 reading plans, 25+ biblical stories (with children's versions).

### Family Trees

[429+ biblical figures](https://kjvstudy.org/family-tree) across 77+ generations from Adam through the New Testament — with interactive ancestor/descendant navigation, biographical data, and GEDCOM-based genealogy.

### PDF Export

Downloadable PDFs for verses, chapters, books, study guides, stories, and reading plans.

### Accessibility

Keyboard navigation (Vim-style and arrow keys), screen reader support, text-to-speech, dark mode with system preference detection, and adjustable font sizes. See [/accessibility](https://kjvstudy.org/accessibility).

---

## Architecture

```
kjvstudy_org/
├── server.py                # FastAPI application
├── kjv.py                   # Bible text access
├── routes/                  # 16 route modules
├── utils/                   # Search, PDF, commentary helpers
├── templates/               # 77 Jinja2 templates
├── static/                  # Tufte CSS, ET Book fonts, JS
└── data/                    # Bible text, commentary, interlinear,
                             # Strong's, cross-references, topics,
                             # study guides, reading plans, stories,
                             # genealogy, timeline, and more
```

| | |
|---|---|
| **Backend** | FastAPI, Python 3.13, Gunicorn |
| **Frontend** | Tufte CSS, ET Book, vanilla JS |
| **Data** | JSON, SQLite (search), gzip (interlinear) |
| **PDF** | WeasyPrint |
| **Packaging** | uv |
| **Infrastructure** | Docker, nginx, Fly.io |
| **CI/CD** | GitHub Actions |

---

## API

Full REST API with [interactive documentation](https://kjvstudy.org/api/docs).

```
GET /api/verse/{book}/{chapter}/{verse}
GET /api/verse-range/{book}/{chapter}/{start}/{end}
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}
GET /api/verse-of-the-day
GET /api/bible
```

All endpoints support book name abbreviations (Gen, Ex, Mt, Rev, &c.).

---

## Development

```bash
# With Docker (recommended)
docker compose up

# Without Docker (requires Python 3.13+ and uv)
uv sync
uv run kjvstudy-org

# Tests (941 tests across 16 files)
uv run pytest tests/ -v

# Data validation
uv run python scripts/validate_data.py
```

## Deployment

Deployed to [Fly.io](https://fly.io) with `fly deploy`. Production runs behind nginx for static asset caching, with Gunicorn/Uvicorn serving the FastAPI application. Health checks, auto-recovery, and HTTPS are configured out of the box.

---

## 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