Skip to content

Repository files navigation

HebRabbAI

Hebrew Tanakh studio: reading path, nikkud, lexicon, recitation with word wash, dialect-aware echo, aleph-bet, BIBL 630 vocab drill, and handwriting.

This repo is the student packet. It is a sibling of haday — it does not replace that trainer, and nothing here is pushed back into it.

Where we are: Phase 1 student layer is in the product. Cloud accounts, Docker, and Whisper GPU are deferred. Full tick-boxes: docs/CHECKLIST.md (progress + testing phase).

Family of repos

Repo What it is Rule
HebRabbAI_Docs (haday/) BIBL 630 vocab trainer, live at haday.vercel.app Do not modify. Complete on its own.
hebrew-tutor-data-pipeline GPU force-align + SBL audio indexer Leave it. Whisper/CUDA stays there.
HebRabbAI (this) Whole student-facing studio Parallel product. Copies, not a fork.

Earlier shells (hebrew-tutor-ai, tanakh_ai_tutor, hebrew_tutor_ai_poc) are unused. Do not overwrite them with this packet.

What this app is

A Phase 1 tutor. Open any of the 39 books. Follow a sixteen-verse path. Tap a word. Listen to a recitation on the lesson chapters. Echo the line. Drill first-year vocabulary. Write the letters.

Progress (path, streak, echo scores, SRS cards, dialect) lives in this browser. No accounts.

Salvaged into this studio

From haday (static copies, not a submodule): aleph-bet + vowels, handwriting pad with local glyph check, BBH vocab list, SM-2-style SRS, week sets, verse examples. See docs/ATTRIBUTION.md.

From hebrew-tutor-data-pipeline: SBL audio catalog (39/39 chapters), verse-slice alignment clock (the interpolator used when Whisper timestamps are missing). Lesson-chapter recitations are included so Listen does not depend on a Windows audio disk.

Data

Complete Tanakh, lazy-loaded per book under public/tanakh. Famous verses carry English; others, ask the tutor.

Path

Sixteen gated readings (beginner / intermediate / advanced), including Shema, the Decalogue, Psalm 23, Jonah, Job, Proverbs.

Echo scores each word against the microphone (Levenshtein, one-skip align). Dialects: Modern Israeli, Sephardic, Ashkenazi.

Recitation

Lesson chapters play a public study recitation (Mechon Mamre), sliced to the open verse by consonant-weighted timing. Other chapters use the tutor voice. Drop a chapter MP3 at public/audio/{SBL}/{n}.mp3 to add more.

Shipped chapters: Genesis 1, Exodus 20, Deuteronomy 6, Psalm 1, Psalm 23, Isaiah 6, Ruth 1, Jonah 1, Job 1, Proverbs 1.

Vision mapping

Plan Here now
Lesson selection + progress Path tab
Pronunciation visualization Echo bars + verse wash
Alphabet + handwriting Aleph / Write
Vocab + SRS Drill (haday lemmas)
Chapter audio + word clock Listen on lesson chapters
LLM explanations Ask the tutor
Full Tanakh 39 books, per-book fetch
JWT / Postgres / Whisper GPU Deferred until accounts are requested

Testing

Gates A–F (compile, product walkthrough, corpus, sibling regression, beta exit, deferred cloud) live in docs/CHECKLIST.md. Last compile + corpus pass: 24 Aug 2026 (ketiv/qere glue repaired).

Run

Node 22+. Auth stays off.

npm install
npm run dev

npm run typecheck is the compile gate.

Not this repo

The CUDA force-aligner, Azure blob audio disk, FastAPI/Docker shells, and haday accounts/leaderboard stay in their own repos. This product does not depend on react-scripts.

About

HebRabbAI Tanakh studio: path, recitation, echo, aleph-bet, vocab drill, handwriting. Parallel to haday; does not replace it.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages