A lightweight IRC bot that provides real-time weather information using the Open-Meteo API. WeatherBot is designed to be simple to set up, easy to configure, and free to use as it relies on the free Open-Meteo API service.
Join us on MansionNET IRC to chat with us, test the bot, and play some trivia!
🌐 Server: irc.inthemansion.com
🔒 Port: 6697 (SSL)
📝 Channel: #opers, #general, #welcome, #devs (and many others)
- Real-time weather information for any city worldwide
- Temperature, humidity, wind speed, and weather condition reporting
- SSL/TLS support for secure IRC connections
- Easy to configure and customize
- No API key required
- Rate limiting to prevent abuse
- Python 3.8 or higher
requests
library- SSL-enabled IRC server
- Clone the repository:
git clone https://github.com/MansionNET/weatherbot.git
cd weatherbot
- Create and activate a virtual environment (recommended):
python -m venv venv
source venv/bin/activate # On Windows use: venv\Scripts\activate
- Install dependencies:
pip install -r requirements.txt
Start the bot:
python weatherbot.py
In any channel where the bot is present:
!weather <city>
- Get current weather for the specified city- Example:
!weather London
- Example:
!weather "New York"
- Example:
!help
- Display available commands
WeatherBot uses two free APIs from Open-Meteo:
- Geocoding API for city lookup
- Weather API for weather data
No API key is required, but please review their terms of service before deployment.
Contributions are welcome! Please read our Contributing Guide for details on how to submit pull requests, report issues, and contribute to the project.
This project is licensed under the MIT License - see the LICENSE file for details.
- Open-Meteo for providing free weather data
- The IRC community for continued support of the protocol
This project is actively maintained. If you encounter any issues or have suggestions, please open an issue on GitHub.