Hebrew Bible Analysis Suite 📜

Project Link

Visit the app at bible-codes.github.io

---

Overview

Welcome to the Hebrew Bible Analysis Suite – a comprehensive, browser-based platform for exploring the Hebrew Bible through multiple analytical lenses. This unified application combines traditional Torah study tools with modern computational analysis, all running entirely in your browser with full offline capability.

---

🎯 Current Features

🔴 Active Tools

• ELS Bible Codes Search (bible-codes.html)
  • Equidistant Letter Sequence (ELS) searches
  • Precomputed hashes for common phrases
  • Dynamic search for custom inputs
  • Skip distance analysis
• Hebrew Text Search (text-search.html)
  • Advanced pattern matching with regex support
  • First/last letter filtering
  • Auto-suggestions
  • Consonantal and full text modes
• Gematria Calculator (gematria.html)
  • Multiple calculation methods (standard, reduced, ordinal)
  • Search by value or range
  • Find matching words
  • Statistical analysis
• Acronym/Notarikon (acronym.html)
  • Extract Roshei Teivot (first letters) and Sofei Teivot (last letters)
  • Search by acronym pattern
  • Book-wide analysis
  • Multiple extraction methods

🟡 In Development

• Tsirufim (צירופים) - Semantic permutation analysis with ML-powered clustering

🟢 Planned Features

• Letter & Word Analysis - Character-level statistical analysis
• Cantillation Viewer - Taamim analysis including alternate traditions
• Cross-Reference Index - Links to Talmud, Midrash, and Zohar citations
• Anagram Solver - Pattern detection and permutations

---

⚡ Key Features

Comprehensive Analysis Tools

• ELS Search: Fast, efficient Equidistant Letter Sequence searches
• Text Search: Keyword, phrase, and pattern matching
• Gematria: Multiple calculation methods with value-based searches
• Notarikon: First/last letter extraction and acronym analysis
• Statistical Analysis: Letter counts, word patterns, structural queries

Technical Excellence

• 100% Client-Side: No server required, runs entirely in browser
• Fully Offline Capable: PWA architecture enables complete offline functionality - all searches, calculations, and analysis work without internet
• Character-Level Database: Future-proof architecture using IndexedDB (50-100MB storage)
• Web Workers: Heavy computations (ELS, text search) run in background threads for responsive UI
• Cross-Platform: Works on desktop, tablet, and mobile devices
• Installable: Add to home screen and run as standalone app

Data Features

• Niqqud Aware: Supports vowel points in searches
• Taamim Support: Cantillation marks analysis
• Alternate Traditions: Support for variant readings (e.g., Aseret HaDibrot)
• Precomputed Values: Fast lookups for common searches
• Compressed Storage: Efficient data storage for offline use

---

🔧 Technology Stack

Frontend

• JavaScript (ES6+): Core application logic
• IndexedDB: Large dataset storage and querying (50-100MB practical limit)
• Web Workers: Background processing for heavy searches (ELS, full-text)
• Service Worker: Offline caching and PWA functionality
• WebAssembly (WASM): Optional high-performance compute for future optimizations

Data Architecture

• Character-Level Database: Canonical storage of every Hebrew letter
• Derived Views: Words, verses, and analysis built on character data
• Precomputed Indices: Gematria values, letter positions, skip patterns
• Compressed JSON: Efficient storage and transfer

Search Algorithms

• KMP & Boyer-Moore: Optimized string matching
• Hash-Based Lookups: Fast ELS pattern detection
• Indexed Queries: Efficient database operations

---

🚀 Architecture

Database Schema

The application uses a character-level canonical database where each Hebrew letter is a record:

Character Record {
  id: global position (0..304,805)
  book, chapter, verse, word_index
  base_char, final_form
  niqqud, taamim, alt_taamim
  gematria_standard, gematria_reduced, gematria_ordinal
}

This enables:

• ELS searches via global position
• First/last letter queries
• Gematria calculations
• Cantillation analysis
• Statistical queries

File Structure

/
├── index.html              # Main dashboard
├── bible-codes.html        # ELS search tool
├── CLAUDE.md               # Implementation plan
├── data/                   # Text and precomputed data
├── engines/                # Search and analysis engines
├── ui/                     # UI components
└── torah-codes/            # Python reference implementation

---

📚 Background and Inspiration

This project builds on research into Bible codes and computational text analysis:

• Witztum, Doron, et al. "Equidistant Letter Sequences in the Book of Genesis." Statistical Science, vol. 9, no. 3, 1994, pp. 429–38. JSTOR.
• Works by Michael Drosnin and Jeffrey Satinover on hidden codes
• Traditional Jewish approaches to gematria and notarikon
• Modern computational linguistics and statistical analysis

---

🌟 Open Source

This project is open source and free to use. Contributions are welcome!

Related Projects

• Bible Codes App - This repository
• Bible Data Science - Jupyter notebooks and research tools

---

🤝 Contributing

We welcome contributions of all kinds:

1. Fork the Repository: Start by forking this project
2. Submit Issues: Report bugs or request features in Issues
3. Open Pull Requests: Submit PRs for bug fixes or new features
4. Improve Documentation: Help make the project more accessible
5. Share Ideas: Suggest new analysis tools or features

Development Setup

See CLAUDE.md for detailed implementation plans and architecture documentation.

---

📖 Usage

1. Visit bible-codes.github.io
2. Choose a tool from the dashboard
3. Install as PWA (optional) for offline use
4. Explore the Hebrew Bible with powerful analysis tools

---

📧 Contact

• Email: roni762583@gmail.com
• GitHub: bible-codes

---

📄 License

See LICENSE for details.

---

Last Updated: 2026-01-11

Thank you for exploring the Hebrew Bible Analysis Suite!