Skip to content

A modern KJV Bible study platform with interlinear Hebrew/Greek, Strong's Concordance, AI commentary, family trees, topical studies, and full-text search. Built with FastAPI and Tufte CSS.

License

Notifications You must be signed in to change notification settings

kennethreitz/kjvstudy.org

Repository files navigation

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

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:

Reading Plans:

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

About

A modern KJV Bible study platform with interlinear Hebrew/Greek, Strong's Concordance, AI commentary, family trees, topical studies, and full-text search. Built with FastAPI and Tufte CSS.

Topics

Resources

License

Stars

Watchers

Forks