🌤️ Telegram Weather Bot

A Python Telegram bot that fetches real-time weather data from OpenWeatherMap and automatically delivers hourly reports to your Telegram chat using APScheduler.

---

📖 Overview

Telegram Weather Bot is a Python-based bot that connects the Telegram Bot API with the OpenWeatherMap API to deliver real-time weather updates for Dhaka, Bangladesh (configurable to any city). Once started, the bot automatically pushes a full weather report to your Telegram chat every hour using a background scheduler - no manual trigger needed. It also responds to on-demand commands for instant updates and control.

---

✨ Features

• 📡 Real-time weather data: temperature, humidity, wind speed, pressure, visibility, and weather condition
• ⏱️ Hourly auto-reports: APScheduler pushes updates every hour without any user action
• 🤖 Bot commands: full control via /start, /stop, and /test
• 📍 City-configurable: defaults to Dhaka, Bangladesh; change to any city in one line
• 🔒 Secure API keys: credentials loaded from environment variables, never hardcoded
• 🪶 Lightweight: no database, no web server; just Python running in the background

---

🤖 Bot Commands

Command	Action
/start	Begin receiving hourly weather reports
/stop	Stop the hourly weather schedule
/test	Get an immediate weather report and confirm the bot is alive

---

🌡️ Weather Report Fields

Each report includes the following live data from OpenWeatherMap:

Field	Description
🌡️ Temperature	Current temp in °C
🌡️ Feels Like	Perceived temperature
💧 Humidity	Relative humidity (%)
💨 Wind Speed	Speed in m/s
🌬️ Pressure	Atmospheric pressure (hPa)
👁️ Visibility	Visibility in metres
☁️ Condition	Sky condition (e.g., Clear, Cloudy, Rain)

---

🔧 How It Works

User sends /start on Telegram
         │
         ▼
   pyTelegramBotAPI receives the command
         │
         ▼
   APScheduler starts a background job
         │  (runs every 60 minutes)
         ▼
   OpenWeatherMap API called
         │  → Returns live JSON weather data
         ▼
   Bot formats the weather message
         │
         ▼
   Message sent to user's Telegram chat ✅

/stop cancels the scheduled job. /test triggers a single immediate fetch outside the schedule.

---

🛠️ Tech Stack

Tool	Purpose
Python 3	Core language
pyTelegramBotAPI	Telegram bot API wrapper
APScheduler	Background hourly job scheduler
OpenWeatherMap API	Real-time weather data source
requests	HTTP calls to the weather API

---

⚙️ Requirements

• Python 3.7+
• pyTelegramBotAPI
• APScheduler
• requests

---

🚀 Getting Started

Step 1: Get Your API Keys

Telegram Bot Token

1. Open Telegram and message @BotFather
2. Send /newbot and follow the prompts
3. Copy your bot token

OpenWeatherMap API Key

1. Sign up at openweathermap.org
2. Go to API Keys in your account dashboard
3. Copy your free API key

---

Step 2: Clone the Repository

git clone https://github.com/MusaIslamFahad/telegram-weather-bot.git
cd telegram-weather-bot

Step 3: Install Dependencies

pip install pyTelegramBotAPI APScheduler requests

Step 4: Set Environment Variables

Option A: Export directly (Linux / macOS)

export BOT_TOKEN="your_telegram_bot_token"
export WEATHER_API_KEY="your_openweathermap_api_key"

Option B: Set in terminal (Windows CMD)

set BOT_TOKEN=your_telegram_bot_token
set WEATHER_API_KEY=your_openweathermap_api_key

Option C: Use a .env file (recommended)

Create a .env file in the project root:

BOT_TOKEN=your_telegram_bot_token
WEATHER_API_KEY=your_openweathermap_api_key

Then install python-dotenv and load it at the top of the script:

from dotenv import load_dotenv
load_dotenv()

⚠️ Security: Always add .env to your .gitignore — never commit API keys to GitHub.

---

Step 5: Run the Bot

python "Telegram_bot/Telegram Weather Bot.py"

Then open Telegram, find your bot, and send /start.

---

🔧 Customization

Change the City

In the bot script, find the API call and update the city name:

city = "Dhaka"   # Change to any city, e.g. "London", "Tokyo", "New York"

Change the Update Interval

In the APScheduler configuration, update the interval (in minutes):

scheduler.add_job(send_weather, 'interval', minutes=60)
# Change 60 to any value, e.g. 30 for every 30 minutes

---

📂 Project Structure

telegram-weather-bot/
│
├── Telegram_bot/
│   └── Telegram Weather Bot.py   # Main bot script
│
├── .env                          # API keys — DO NOT commit (add to .gitignore)
├── .gitignore
├── screenshots/                  # README screenshots
└── README.md

Recommended .gitignore:

.env
__pycache__/
*.pyc

---

🔮 Future Enhancements

• 🌆 Multi-city support: let users request weather for any city via command
• ⏰ Custom intervals: allow users to set their own update frequency from Telegram
• 📅 Forecast reports: add 3-day or 7-day weather forecasts
• 🌐 Inline queries: quick city lookups without switching to the bot chat
• 🐳 Docker support: containerize for easy deployment on any server
• ☁️ Cloud deployment: host on AWS / Heroku / Railway so the bot runs 24/7 without keeping your PC on

---

🤝 Contributing

Contributions and suggestions are welcome!

1. Fork the repository
2. Create a feature branch (git checkout -b feature/your-feature)
3. Commit your changes (git commit -m 'Add your feature')
4. Push to the branch (git push origin feature/your-feature)
5. Open a Pull Request

---

🙏 Acknowledgments

• pyTelegramBotAPI — for the clean and simple Telegram bot wrapper
• OpenWeatherMap — for the reliable free weather API
• APScheduler — for straightforward background task scheduling

---

👨‍💻 Author

Musa Islam Fahad

• GitHub: @MusaIslamFahad

---

⭐ If you found this useful or built something cool on top of it, drop a star. It helps a lot!