{"id":49565222,"url":"https://github.com/aaronjs99/mbab","last_synced_at":"2026-05-03T11:13:11.165Z","repository":{"id":95302472,"uuid":"334459694","full_name":"aaronjs99/mBAB","owner":"aaronjs99","description":"mBAB: The Multi-Book Advanced Bible Search","archived":false,"fork":false,"pushed_at":"2025-12-18T20:19:02.000Z","size":55223,"stargazers_count":8,"open_issues_count":1,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-12-21T21:45:07.281Z","etag":null,"topics":["bible-verse","dbsqlite3","django","flask","python"],"latest_commit_sha":null,"homepage":"http://aaronjs.pythonanywhere.com/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aaronjs99.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-01-30T16:33:55.000Z","updated_at":"2025-12-18T20:19:05.000Z","dependencies_parsed_at":"2025-04-29T01:29:29.693Z","dependency_job_id":"c2c69e64-7efa-4ab3-809b-f65f742b920b","html_url":"https://github.com/aaronjs99/mBAB","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aaronjs99/mBAB","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronjs99%2FmBAB","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronjs99%2FmBAB/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronjs99%2FmBAB/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronjs99%2FmBAB/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aaronjs99","download_url":"https://codeload.github.com/aaronjs99/mBAB/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronjs99%2FmBAB/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32566492,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T06:36:36.687Z","status":"ssl_error","status_checked_at":"2026-05-03T06:36:09.306Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bible-verse","dbsqlite3","django","flask","python"],"created_at":"2026-05-03T11:13:10.478Z","updated_at":"2026-05-03T11:13:11.160Z","avatar_url":"https://github.com/aaronjs99.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# The Multi-Book Advanced Bible Search (mBAB)\n\n## Table of Contents\n\n- [Introduction](#introduction)  \n- [Getting Started for Developers](#getting-started-for-developers)  \n  - [Useful Resources](#useful-resources)  \n  - [Requirements](#requirements)  \n  - [Installation Steps](#installation-steps)  \n  - [Setting Up the Bible Databases](#setting-up-the-bible-databases)  \n  - [Running the Application](#running-the-application)  \n- [Contributors](#contributors)  \n- [Roadmap \u0026 Potential Contributions](#roadmap--potential-contributions)  \n- [License](#license)\n\n## Introduction\n\nThis web application allows users to search for word sequences—case-sensitive or case-insensitive—across a custom selection of Bible books.\n\n**Features**\n- **Multi-book and multi-version search**: Search across any combination of books and versions.\n- **AI-Powered Theological Insights**: One-click explanation of any verse.\n- **Full Chapter Context**: Read the surrounding chapter without leaving results.\n- **Precise Logic Parsing**: AI converts natural language to boolean logic.\n- **Boolean Syntax**: Logical AND (`+`) and OR (`,`) prioritized with parentheses.\n- **Case Sensitivity**: Optional toggle for precise matching.\n- **Smart Book Selector**: Grouped by Testament and Section (Law, Gospels, etc.).\n- **Responsive UI**: Collapsible sidebar and mobile-friendly design.\n- **Themes**: Light ☀️ and Dark 🌙.\n\nHosted live at [aaronjs.pythonanywhere.com](http://aaronjs.pythonanywhere.com/).\n\nOriginally built with Flask, now rebuilt using Django for better scalability and maintainability.\n\n![A Search Example](./searchapp/static/searchapp/images/mBAB_demo.gif \"Searching for either 'holy' or both 'spirit' and 'christ' within the non-Pauline New Testament books in the English Standard Version English Bible\")\n\n## Getting Started for Developers\n\nThis guide will help you set up and run the Multi-Book Advanced Bible Search (mBAB) project locally for development or customization.\n\n### Useful Resources\n\n- [Django Official Documentation](https://docs.djangoproject.com/en/stable/)\n- [Jinja Template Syntax](https://jinja.palletsprojects.com/en/2.11.x/templates/) — used for templating\n- [Python `sqlite3` Module](https://docs.python.org/3/library/sqlite3.html)\n- [Tailwind CSS](https://tailwindcss.com/docs) — for utility-first styling\n\n### Requirements\n\n- Python 3.11 or higher\n- `pip` and `venv` (usually bundled with Python)\n- A Unix-like shell (Linux/macOS or WSL on Windows recommended)\n- `make` (optional but recommended for easier setup and management)\n\n### Installation Steps\n\n```bash\n# Clone the codebase repository\ngit clone https://github.com/aaronjohnsabu1999/mBAB.git ~/mBAB\ncd ~/mBAB\n\n# Set up a virtual environment\nmake venv\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\n\n# Install dependencies\nmake install\n\n# Apply Django migrations\nmake migrate\n```\n\n### Setting Up the Bible Databases\nTo keep the main repo lightweight, the SQLite Bible databases are hosted separately.\nDownload or clone them from Bible Databases and place the `.db` files inside a folder named `databases/` at the root of this project.\n\n```bash\n# Clone the database repository\nmkdir ~/mBAB/databases/\ngit clone https://github.com/aaronjohnsabu1999/bible-databases.git ~/bible-databases/\n\n# Move databases to codebase directory\ncp ~/bible-databases/DB/*.db ~/mBAB/databases/\n```\n\n### Running the Application\nStart the Django development server using make:\n\n#### Default Localhost Run\n\n```bash\nmake run\n```\nThis will run the server at `127.0.0.1:8000`. Open your browser and navigate to [http://localhost:8000/](http://localhost:8000/).\n\n#### Access on a Local Network (e.g., from your phone)\n\nOverride the host and/or port by passing variables:\n\n```bash\nmake run HOST=0.0.0.0            # Binds to all interfaces\nmake run HOST=0.0.0.0 PORT=8080  # Custom port\n```\n\nThen visit in your mobile browser: `http://\u003cyour-computer-local-ip\u003e:8000/`. To find your local IP:\n\n```bash\n# On Linux/macOS\nhostname -I\n\n# On Windows\nipconfig\n```\n\nNote: Ensure both devices are on the same Wi-Fi and that your firewall allows access on the selected port.\n\n## Contributors\n\nFormatting and design feedback have been generously provided by my parents, Sabu John and Jessy Sabu John, along with several other users.\nFlask development support was offered extensively by [@hbhoyar](https://github.com/hbhoyar).\nThe searchable Bible content is based on SQL databases originally published by [@scrollmapper](https://github.com/scrollmapper) and later cleaned and reorganized by me. To keep this repository lightweight and easy to clone, those databases have been moved to a separate repository: [Bible Databases](https://github.com/aaronjohnsabu1999/bible-databases).\n\n## Roadmap \u0026 Potential Contributions\n\n### Search Capabilities\n- [x] Pagination for search results\n- [x] Natural language search (e.g., \"verses about forgiveness\")\n- [x] Logical grouping with parentheses in search syntax\n- [x] Subdivide books by genre (Law, Gospels, etc.)\n- [x] Track recent searches\n- [ ] Search within verse ranges (e.g., John 3:16–21)\n- [ ] Fuzzy matching or stemming (e.g., \"loves\" → \"love\")\n- [ ] Cross-reference lookup (show related verses)\n- [ ] Search by Strong's numbers for original language study\n\n### AI Features\n- [x] One-click theological explanations for any verse\n- [x] Full chapter context reader\n- [ ] Comparative analysis across translations\n- [ ] AI-generated study notes\n- [ ] Topic-based verse recommendations\n\n### User Features\n- [x] Bookmarking/saving favorite verses (via local storage)\n- [x] User guide and help modal\n- [ ] Optional user accounts with cloud sync\n- [ ] Export saved verses (PDF, text, clipboard)\n- [ ] Share verses via link or social media\n- [ ] Audio playback of verses (text-to-speech)\n\n### Accessibility \u0026 Internationalization\n- [ ] Multi-language UI (Spanish, Hindi, Malayalam, etc.)\n- [ ] Keyboard-only navigation mode\n- [ ] Screen reader optimization\n- [ ] Support copyrighted versions (NIV, NLT, etc.) with permission\n\n### Developer \u0026 API\n- [ ] REST API for external integrations\n- [ ] Embeddable widget for church websites\n- [ ] Webhook support for automation\n\n### UI/UX Enhancements\n- [x] Loading animations and skeletons\n- [x] Fully responsive mobile design\n- [x] Collapsible sidebar with filters\n- [x] Light and dark themes\n- [x] Smart section toggles (Select All / Deselect All / Only)\n- [ ] Customizable color themes\n- [ ] Reading mode (distraction-free full-screen)\n\n## License\n\nCopyright © 2025 Aaron John Sabu.\n\nThis project is licensed under the **Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)** license.\n  \n[![CC BY-NC-SA 4.0](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg)](http://creativecommons.org/licenses/by-nc-sa/4.0/)\n\n**You are free to:**\n- **Share** — copy and redistribute the material in any medium or format.\n- **Adapt** — remix, transform, and build upon the material.\n\n**Under the following terms:**\n- **Attribution** — You must give appropriate credit, provide a link to the license, and indicate if changes were made.\n- **NonCommercial** — You may not use the material for commercial purposes (monetization).\n- **ShareAlike** — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faaronjs99%2Fmbab","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faaronjs99%2Fmbab","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faaronjs99%2Fmbab/lists"}