Despite the name, PyWeather has moved past its Python roots. It is now a dual-experience project: a lightweight web application built in HTML, CSS, and JavaScript, alongside a native Android application built in Flutter.
The idea is simple. We wanted a weather app that provides highly accurate, real-time data and looks incredibly clean—using Google's Material Design principles—but delivers the forecast the way someone actually talks when they step outside and it's freezing.
By utilizing Flutter for the mobile build, the app is easier to maintain and provides a solid native experience on Android, while the web version keeps things accessible for anyone with a browser.
- Native Android App: Compiled with Flutter for smooth performance on Android devices.
- Web App: A straightforward, accessible counterpart built with standard web technologies.
- Material Design: A clean UI that mirrors native Google applications, focusing on typography, layout, and dark mode support.
- Unfiltered Forecasts: Dynamically generates aggressive, profane, and honest weather descriptions based on the current temperature, precipitation, and wind conditions.
- In-App Settings: No need to configure
.envfiles or API keys. All settings, including vulgarity levels, are managed directly through the app's user interface. - Open-Meteo Integration: Global, accurate weather data provided by the Open-Meteo API.
| Clean Material UI | Vulgar Forecasts | Settings & Options |
|---|---|---|
 |
 |
 |
- Flutter SDK (if you intend to build or run the Android app).
- An Android device or emulator.
-
Clone the repository:
git clone https://github.com/kashcotton/pyweather.git cd pyweather -
Get dependencies:
flutter pub get
-
Run the application: Ensure your device or emulator is running, then execute:
flutter run
Note: You can adjust the app's behavior and vulgarity levels in the settings menu once it is running.
Navigate to the web directory in the repository and open the index.html file in your browser, or host the directory on your preferred web server.
- Flutter & Dart: Used for the native Android application shell.
- HTML / CSS / JavaScript: Used for the core web application logic and styling.
- Open-Meteo API: For fast, keyless weather data.
A massive thanks to colebolebole for creating the original Python and OpenWeatherMap iteration of this project. We worked on that version together, and this new Flutter/Web iteration was built directly on the foundation of that original concept.
If you have ideas for new features, bug fixes, or just want to add some creative new insults to the weather generator, feel free to contribute.
- Fork the project.
- Create your feature branch (
git checkout -b feature/NewFeature). - Commit your changes (
git commit -m 'Add a new feature'). - Push to the branch (
git push origin feature/NewFeature). - Open a Pull Request.
Distributed under the Apache License 2.0. See the LICENSE file for more information.
Disclaimer: This app contains strong language and profanity by design.