Skip to content

ayushmandas29/weather-cli

Repository files navigation

🌦️ Weather CLI

Python License Contributions Platform

A lightweight, beginner-friendly open-source Python CLI Weather Application that fetches real-time weather using the wttr.in API.


🚀 Features

  • 🌍 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

📥 Installation

1️⃣ Clone the repository

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