Weather

Weather

Wraps the OpenWeatherMap API. The container needs OPENWEATHER_API_KEY exported (set it in mimirbot/.env if running there).

Usage

Always invoke via Python module syntax — python3 -m mimir.skills.weather.scripts.get_weather. The script ships inside the installed mimir package, so the -m form resolves no matter where the venv lives or what cwd the shell tool spawns from.

Do not invoke as a filesystem path. Forms like python3 mimir/skills/weather/scripts/get_weather.py only resolve from a source checkout — from a PyPI install (pip install mimir-agent) the script lives under site-packages/ and the relative path will fail with "No such file or directory." To confirm the script is correctly installed, python3 -c "import mimir.skills.weather.scripts.get_weather" should exit 0.

# Default location (set inside the script — Victor, NY, US).
python3 -m mimir.skills.weather.scripts.get_weather

# Specific city. Comma-separated; ISO country codes for disambiguation.
python3 -m mimir.skills.weather.scripts.get_weather "London,UK"
python3 -m mimir.skills.weather.scripts.get_weather "San Francisco,CA,US"

The script does NOT use argparse — anything that isn't --json is treated as the city name. So python3 -m mimir.skills.weather.scripts.get_weather --help sends --help to OpenWeatherMap as a city query and 404s. There is no --help flag; use the examples above as reference.

Default output is plain text (current conditions + 5-day high/low/precip). Add --json when you want to format the output yourself or pull specific fields:

python3 -m mimir.skills.weather.scripts.get_weather "Tokyo,JP" --json

The JSON shape:

{
  "current": {
    "location": "...",
    "description": "...",
    "temp_f": 72,
    "feels_like_f": 70,
    "humidity_pct": 55,
    "wind_mph": 8
  },
  "forecast": [
    {"date": "2026-05-04", "high_f": 75, "low_f": 58, "description": "...", "precip_chance_pct": 20},
    ...
  ]
}

When to use

• User asks about weather in a specific place ("what's it like in Boulder right now?", "any rain this week in NYC?").
• Planning anything outdoor — give the high/low and precip chance for the relevant days, not the full 5-day spread.
• Following up on an earlier weather mention ("you said it'd be hot today, what's the forecast for tomorrow?").

When NOT to use

• The user's already on a weather app and just venting about it.
• Hyperlocal questions (microclimates, exact rainfall) — the API is at city-resolution; defer to a more specialized source.
• If OPENWEATHER_API_KEY is unset the script exits with a clear error; surface that to the operator rather than guessing.