Yabtob/Ethio-Amharic-Bible-Telegram-bot

Ethio Amharic Bible Bot A Telegram bot and Bible API project for Amharic scripture. The repository includes: - `bots.py`: a Telegram bot that supports `/verse`, `/search`, `/daily`, and `/help` commands. - `utils/verse.py` and `utils/search.py`: helper modules that retrieve verses from a SQLite database. - `amharic-bible-json/`: # Ethio Amharic Bible Bot A Telegram bot and Bible API project for Amharic scripture. The repository includes: - `bots.py`: a Telegram bot that supports `/verse`, `/search`, `/daily`, and `/help` commands. - `utils/verse.py` and `utils/search.py`: helper modules that retrieve verses from a SQLite database. - `amharic-bible-json/`: JSON data for the full Amharic Bible and each book. - `Bible-Api/`: a separate Node.js Bible API backend for Oromo, Amharic, and English versions. ## Features - Random verse lookup (`/verse`) - Text search of verse content (`/search `) - Daily verse message support - Amharic Bible JSON data for offline parsing - Additional API service under `Bible-Api/` ## Prerequisites - Python 3.8+ installed - `python-telegram-bot` library - `requests` library - Telegram bot token - SQLite database file named `bible.db` in the root project directory > Note: The repository does not currently include `bible.db`. You must create or provide this database with a `verses` table before running the bot. ## Installation 1. Clone the repository. 2. Create and activate a Python virtual environment: ```powershell python -m venv .venv .\.venv\Scripts\Activate.ps1 ``` 3. Install Python dependencies: ```powershell pip install -r requirements.txt ``` 4. Add your Telegram bot token in `config.py`: ```python TOKEN = "your-telegram-bot-token" ``` ## Running the Telegram Bot From the repository root, run: ```powershell python bots.py ``` The bot will start polling Telegram and respond to commands. ## Telegram Commands - `/verse` - returns a random Bible verse - `/search ` - searches verse text for a keyword - `/daily` - returns a daily verse - `/help` - shows available commands ## Project Structure - `bots.py` - main bot entry point - `config.py` - stores the Telegram bot token - `utils/verse.py` - selects a random verse from SQLite - `utils/search.py` - searches verse text in SQLite - `amharic-bible-json/` - Amharic Bible JSON data files - `Bible-Ap …