Weatherly is a sleek, fast, and responsive weather dashboard built with Streamlit, fetching real-time weather, air quality, and a 3-day forecast for any city — powered by WeatherAPI.com.
🌐 Live Project: weatherly-smzufohbhuex5grhcavnd4.streamlit.app
🔐 API keys are securely stored using
secrets.toml— no hardcoding.
- 🌍 Real-time weather for any city worldwide
- 📊 Details: Temperature, humidity, UV index, cloud cover, wind speed/direction
- 🫁 Air quality score (PM2.5-based) with emoji scale
- 📅 3-day forecast with dynamic weather icons
- ⏱ Live local time + last updated timestamp
- 🎨 Auto-switching weather icons (sunny, storm, fog, etc.)
| Component | Technology |
|---|---|
| Backend | Python |
| Frontend/UI | Streamlit |
| API | WeatherAPI (REST) |
| Secrets Mgmt | secrets.toml |
| Deployment | Streamlit Cloud 🌨️ |
- Sign up at WeatherAPI.com and get your free API key.
- In your Streamlit app folder, create a
.streamlit/secrets.tomlfile:
[api] key = "your_weather_api_key_here"
✅ Never commit your API key to GitHub — keep it in secrets.toml.
$ git clone https://github.com/yourusername/weatherly.git $ cd weatherly $ pip install -r requirements.txt $ streamlit run app.py
Make sure:
Your secrets.toml is inside .streamlit/ folder
Your main file is named app.py (or update the run command)
☁️ Deploy on Streamlit Cloud
-
Push your code to GitHub
-
Go to share.streamlit.io and connect your repo
-
Add your API key in App Settings → Secrets:
[api] key = "your_api_key"
- Deploy — you’re live!
📌 Example API Call
https://api.weatherapi.com/v1/forecast.json?key=YOUR_KEY&q=London&days=3&aqi=yes
Returns:
Current weather
PM2.5 air quality
3-day forecast
📝 Notes
Works best for cities with API coverage
PM2.5 Air Quality Scale:
🟢 Excellent
🟡 Moderate
🟠 Poor
🔴 Hazardous
Icons sourced from Google Weather Icons
👤 Author
Ameya Kulkarni
📜 License: MIT — free to use, modify, and share.
⭐ If Weatherly helped you, drop a star!