weather-tty 0.3.0

Tiny CLI to print today's weather for your terminal (Open-Meteo, zero API key).

🌦️ weather-tty

Tiny CLI to print today's weather for your terminal — zero API keys, just vibes.

Preview

Features

• Zero-config: just type weather-tty and it will guess your city by IP.
• Single-line summary: 🌤️ Pamplona, ES: 25°C/12°C · rain 0.0mm · wind 18 km/h · sun 08:10–19:14
• Multi-day forecast: weather-tty --forecast for a 5-day table.
• --city geocoding (Open-Meteo) or --lat/--lon.
• Units: metric (default) or imperial.
• --timezone to override the auto-detected IANA timezone.
• --no-emoji for boring terminals.
• --verbose pretty panel for humans.
• --version to print the installed version.

Install

Requires Python 3.10+

Recommended (pipx)

The easiest way to install weather-tty as a CLI tool:

brew install pipx  # if you don't have pipx
pipx install weather-tty

This installs weather-tty in an isolated environment and makes it available globally.

Alternative (pip)

pip install weather-tty

⚠️ On macOS with Homebrew Python, you may get an externally-managed-environment error. Use pipx instead, or create a virtual environment.

Usage

# auto-detect city by IP
weather-tty

# by city
weather-tty --city "Pamplona"

# 5-day forecast table
weather-tty --city "Pamplona" --forecast

# coordinates (overrides city)
weather-tty --lat 40.4168 --lon -3.7038

# imperial units
weather-tty --city "New York" --units imperial

# pretty panel
weather-tty --city "Pamplona" --verbose

# override the timezone
weather-tty --city "Pamplona" --timezone Europe/Madrid

# print version
weather-tty --version

Pro Tip: Terminal Greeting

Add weather-tty to the end of your .zshrc, .bashrc, or .bash_profile to get a fresh weather report every time you open a new terminal session:

# Add this to ~/.zshrc or ~/.bashrc
weather-tty

Notes

• Data source: Open-Meteo
• No API keys required.
• Default view is today's summary; pass --forecast for a 5-day table.
• Location is resolved via IP by default; override with --city or --lat/--lon.

Development

uv sync --group dev
uv run ruff check .            # lint
uv run ruff check . --fix      # autofix
uv run ty check                # type check (Astral ty)
uv run pytest --cov=weather_tty --cov-report=term-missing  # tests + coverage
uv run weather-tty --city "Pamplona"