An open API service indexing awesome lists of open source software.

https://github.com/brickfrog/verbum-diei

Daily scripture mirroring readings chosen by the Vatican's 'Word of the Day' / marginalia + LLM commentary
https://github.com/brickfrog/verbum-diei

bible bible-study bible-verses

Last synced: 5 months ago
JSON representation

Daily scripture mirroring readings chosen by the Vatican's 'Word of the Day' / marginalia + LLM commentary

Awesome Lists containing this project

README

          

# verbum-diei

Daily “Word of the Day” (Vatican News RSS) rendered as a static page with:
- scripture text from a public-domain translation (Douay-Rheims 1899 American Edition / `DRA`, stored locally)
- LLM marginalia + line-referenced commentary (optional; runs once per day)
- liturgical observances (local calc via `romcal`)

## Setup

- Install deps: `bun install`
- Optional: set `OPENAI_API_KEY` to enable marginalia + commentary
- Defaults to `VERBUM_OPENAI_MODEL=gpt-5.2` (override with `VERBUM_OPENAI_MODEL` or `OPENAI_MODEL`)

## Generate today

- `bun run generate`
- Pick a specific date (YYYY-MM-DD): `bun run generate -- --date 2025-12-13`

Outputs:
- `public/index.html`
- `public/data/YYYY-MM-DD.json`
- `public/d/YYYY-MM-DD/index.html`
- `public/archive/index.html`

## Bible text source

- Stored in `assets/bible/dra1899.json` (public domain; derived from Project Gutenberg eBook #8300).
- To rebuild it: `curl -fsSL -o scripts/dra1899.source.txt https://www.gutenberg.org/cache/epub/8300/pg8300.txt && node scripts/build-dra1899.mjs`

## Preview

- `bun run serve` then open `http://localhost:5173`

## Publish (GitHub Pages)

- Create a repository secret `OPENAI_API_KEY` (optional; only needed for LLM output).
- Run the workflow once (`Actions` → `Daily generate` → `Run workflow`) to create/update the `gh-pages` branch.
- Configure Pages to deploy from the `gh-pages` branch (root).
- `.github/workflows/daily.yml` runs daily, generates the site, and publishes `public/` to `gh-pages` (keeping `main` free of generated artifacts).