A lightweight, beginner-friendly open-source Python CLI Weather Application that fetches real-time weather using the wttr.in API.
- 🌍 Works on Windows, Linux, and macOS
- ⚡ Fetches weather instantly
- 📦 Requires only one dependency:
requests - 🎯 Beginner-friendly codebase
- 📡 Uses the free wttr.in weather API
- 🛠 Easy to contribute and extend
git clone https://github.com/ayushmandas29/weather-cli.git
cd weather-cli
2️⃣ Install requirements
bash
Copy code
pip install -r requirements.txt
▶️ Usage
Run:
bash
Copy code
python main.py
Example:
yaml
Copy code
=== Advanced Weather App (CLI) ===
Enter city name: Mumbai
Weather Report:
Mumbai: ☀️ +32°C
📁 Project Structure
css
Copy code
weather-cli/
│── main.py
│── requirements.txt
│── README.md
└── LICENSE
🧠 Roadmap
Upcoming improvements:
Add colored terminal output (rich library)
Add multi-day forecast support
Add error handling for invalid cities
Add unit tests
Add auto city detection (IP-based)
Make it installable using pip
Add Dockerfile support
🧩 Contributing
We welcome all contributions!
Fork the repo
Create a new branch:
bash
Copy code
git checkout -b feature-name
Commit your changes
Push your branch
Open a Pull Request
Read the full guide in CONTRIBUTING.md.
🐛 Issues
Found a bug? Have a feature idea?
👉 Open an issue:
https://github.com/ayushmandas29/weather-cli/issues
📜 License
This project is licensed under the MIT License.
⭐ Support the Project
If you like this project:
⭐ Star the repo
🍴 Fork it
🐛 Open issues
🚀 Submit pull requests
👨💻 Author
Ayushman Das