weather-tty 0.2.1

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.

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.
• --no-emoji for boring terminals.
• --verbose pretty panel for humans.

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

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.
• Prints today (index 0 of daily arrays). If you want multi-day, PRs welcome.

Development

uv sync
uv sync --group dev
uv run ruff check .
uv run ruff check . --fix
uv run pytest
uv run weather-tty --city "Pamplona"