# bibliotokos.com

> Parallel scripture reader and free Bible API. Public-domain and original-language texts, plus two LLM English renderings. Hosted for free by Insula Labs, LLC. Signed-in natural-language search is in progress.

bibliotokos.com is a small journal-styled site for reading scripture side by side. The home page (`/`) is the brand lander. The scripture reader (`/scripture`) is a public reference lookup: type a passage, add translation panes, and scroll them together. Light and dark follow the system until you pick one. There are no ads and no notes product on the web. Hosting is provided free by [Insula Labs, LLC](https://insulalabs.io).

## Texts

Hosted versions (ids in parentheses):

- American Standard Version (`asv`), World English Bible (`web`), King James Version (`kjv`)
- Greek New Testament (`gnt`), Septuagint (`sep`), Tanach (`tan`), Vulgate (`vul`)
- Emergent Noetic Version (`env`): English verse-by-verse LLM rendering of the Tanach and Greek NT
- Vulgate Emergent Noetic Version (`venv`): English LLM rendering of the Vulgate

ASV, WEB, KJV, GNT, Septuagint, Tanach, and Vulgate come from the [Sacred Texts OSRC](https://sacred-texts.com/bib/osrc/index.htm) (public domain / Creative Commons). ENV and VENV are original to this project.

## Free API

No authentication. An operator can disable the public API; then these routes return `404`.

- `GET /api/bible/versions` — `{ id, name, lang }[]`
- `GET /api/bible/{version}/books` — `{ abbr, name, ord }[]`
- `GET /api/bible/{version}/query?ref=` — passage lookup. `ref` examples: `John 3:16`, `Gen 1`, `Rom 8:28-39`, `Gen 1 - Rev 22`. Optional `from` and `to` instead of `ref`. Optional `offset` and `limit` (max 200) return `{ version, ref, total, offset, verses }` instead of the full set.
- `GET /api/bible/{version}/search?q=&book=` — phrase search (`book` is an optional abbreviation)

Verse objects: `{ book, chapter, verse, version, text }`. Errors are RFC 7807 JSON (`title`, `detail`).

## Signed-in (WIP)

Cookie session after `POST /api/auth/login`. Signed-in users can open `/search` for natural-language / semantic queries. That surface is unfinished.

- `GET /api/bible/nl/catalog` — versions and books for filters
- `POST /api/bible/nl/search` — JSON `{ q, versions?, books?, collections?, from?, to?, limit? }` → ranked hits

## Pages

- [Home](/): brand lander
- [Scripture](/scripture): parallel reader and public lookup
- [This file](/llms.txt): agent map
- [Versions](/api/bible/versions): live catalog when the public API is on
- [Sign in](/login): session for search
- [Search](/search): natural-language search (signed-in, WIP)
- [Insula Labs](https://insulalabs.io): host (Insula Labs, LLC)