This Telegram bot is designed to be a practical assistant for daily life. It provides: π¦οΈ Weather updates for three major Ethiopian cities: Addis Ababa, Haramaya, and Bale Robe. πΏ Daily Islamic quotes for motivation and spiritual guidance. β° Study/prayer reminders to help manage your day.
π RoutineAssistantXBot
Your smart daily-routine assistant on Telegram β providing weather updates, Islamic prayer times, motivational quotes, and study reminders in one simple bot.
β¨ Features
βοΈ Weather Updates
Get accurate weather information for selected Ethiopian cities.
π Prayer Times
Receive daily Islamic prayer times with a beautiful, clean format.
π¬ Motivational Quotes
Daily inspirational quotes to boost your mindset.
β° Study/Task Reminder (Demo)
A simple reminder to help you stay productive.
π Available Bot Commands
/start β Show bot menu
/weather_addis β Weather for Addis Ababa
/prayer_addis β Prayer times for Addis Ababa
/prayer_haramaya β Prayer times for Haramaya
/prayer_balerobe β Prayer times for Bale Robe
/quote β Get a motivational quote
/reminder β Demo reminder system
π§ Tech Stack
Python 3.10+
python-telegram-bot v21+
OpenWeatherMap API
Aladhan Prayer API
dotenv for managing environment variables
π Project Structure
.
βββ main.py # Main bot code
βββ .gitignore # Hidden files list (.env is excluded)
βββ requirements.txt # Python dependencies
βββ .env (not uploaded) # Contains secret API keys
π Environment Variables
Create a .env file in your project root:
TELEGRAM_BOT_TOKEN=YOUR_TOKEN_HERE
OPENWEATHER_API_KEY=YOUR_API_KEY_HERE
β οΈ Never upload .env to GitHub!
βΆοΈ How to Run the Bot
Install dependencies:
pip install -r requirements.txt
Run the bot:
python main.py
Enjoy using your RoutineAssistantXBot π
π‘οΈ Security Notes
βοΈ .env file is ignored by GitHub
βοΈ API keys remain private
βοΈ Safe commit history after cleanup
β Support the Project
If you like this bot, feel free to star β the repository or suggest new features!