CLI Weather App in Python Project- Full Guide

📘 Project Title

Command-Line Weather App in Python

📄 Project Description

The CLI Weather App is a lightweight Python application that runs in your terminal and retrieves the current weather for any city in the world. It uses the OpenWeatherMap API to fetch real-time weather information, and displays it in a simple, readable format.

This project is ideal for beginners who want to practice using APIs, working with JSON data, and building clean command-line tools in Python.

🚀 Key Features

🔍 City-Based Weather Search

• Input a city name directly in the terminal

• Fetches current weather conditions using the OpenWeatherMap API

📊 Weather Data Display

• Shows:
  • City and country

  • Temperature (°C)

  • Weather description (e.g., “broken clouds”)

  • Humidity

  • Wind speed

⚙️ Error Handling

• Displays a clear message if:
  • The city is not found

  • The API key is invalid

  • There is no internet connection

📦 Technologies Used

• Python 3

• requests (for API calls)

• json (to parse responses)

• (Optionally) argparse or click (for command-line arguments)

📂 Example Output

BASH:

 

$ python weather_cli.py

Enter city name: London

 

📍 Weather in London, GB:

🌡️ Temperature: 19.3°C

🌤️ Description: Light Rain

💧 Humidity: 78%

💨 Wind Speed: 5.2 m/s

 

🧠 Learning Outcomes

By building this CLI Weather App, you will learn to:

✅ Use Python to consume RESTful APIs

✅ Parse and display JSON data in a clean format

✅ Build a command-line interface with user input

✅ Handle exceptions and error conditions gracefully

✅ Use the requests library effectively

🛠️ Potential Extensions

You can extend the project with:

• A 5-day CLI forecast

• Support for command-line arguments (e.g. python weather_cli.py –city Paris)

• Colored output using libraries like colorama or rich

• Support for saving history to a .txt or .csv file

• Packaging it into an installable CLI tool with setuptools

✅ Summary

• Ideal for beginners and intermediate Python learners

• Runs entirely in the terminal

• Helps you practice API usage, error handling, and CLI development

• No HTML, JS, or web framework required