terminal-weather-cli 0.1.0

Terminal weather forecast service with 3-day outlook and ASCII art

Terminal Weather Service

A small terminal weather forecast service that shows the next 3 days with ASCII weather art.

Features

• 3-day forecast
• Real temperature range and apparent temperature range
• Wind speed and wind direction
• Visibility
• Precipitation amount and precipitation probability
• Metric and imperial unit support
• English and Chinese output
• HTTPS requests for geocoding and weather data

Usage

python main.py
python main.py --location "Shanghai" --lang zh --unit metric
python main.py --location "New York" --lang en --unit imperial
python main.py --show-icons

Development

Install dependencies with uv:

uv sync --group dev

Run lint checks:

uv run ruff check .

Format code:

uv run ruff format .

Apply safe auto-fixes:

uv run ruff check . --fix

Arguments

• --location: city or place name; if omitted, the current location is used
• --lang: en or zh, default zh
• --unit: metric or imperial, default metric
• --show-icons: show all built-in weather icons and labels

Notes

• Forecast and geocoding data are fetched from Open-Meteo over HTTPS.
• Current location is resolved over HTTPS using IP geolocation when --location is omitted.
• Uses rich for terminal table rendering.