A simple yet powerful Telegram bot for verifying Hadiths using their numbers — designed to provide authentic references quickly and effortlessly.
- 🔍 Hadith Lookup — Send a Hadith number, get its text and reference.
- 📚 Authentic Sources — Uses trusted Hadith collection source sunnah.com.
- 🤖 Minimal Setup — Just update your API key and you're good to go.
- Python 3.6+
- A Telegram bot token from BotFather.
-
Clone this repository
git clone https://github.com/abdulmuizz0903/Hadith-Verification-TG-Bot.git cd Hadith-Verification-TG-Bot -
Install dependencies
pip install -r requirements.txt
-
Configure your API Key
Open
hadith_bot.pyand replace:API_KEY = "YOUR_TELEGRAM_BOT_API_KEY"
with your actual bot token.
-
Run the bot
python hadith_bot.py
- Open Telegram and start a conversation with your bot.
- Send a Hadith number (example:
Sahih Bukhari 1234). - The bot will reply with the corresponding Hadith text and reference.
├── hadith_bot.py # Main bot script
├── HadithScraper/ # Separate folder for the people who just want to access the Hadith Scraper.
├── requirements.txt # Dependency list
└── README.md # Project info
Pull requests are welcome! Fork the repository, make your changes, and submit a PR.
This project is licensed under the MIT License.
Have questions or feedback?
Open an issue here: GitHub Issues