Hermes Atlas
Plugins & extensions

Hermes Weather Plugin

FahrenheitResearch/hermes-weather-plugin

Hermes Agent weather plugin with 13 tools for forecasts, alerts, radar, model imagery and soundings

In short

Hermes Weather Plugin is a Hermes Agent plugin that provides 13 tools for observations, forecasts, alerts, model imagery, radar, soundings, calculations and ECAPE. Rust backends are built on first use.

What Hermes Weather Plugin does

Hermes Weather Plugin adds 13 weather tools to Hermes Agent. Data tools such as wx_conditions, wx_forecast, wx_alerts, wx_metar, wx_brief, wx_global and wx_severe call NWS, SPC, METAR and Open-Meteo directly from Python. Image tools render model fields, NEXRAD Level 2 radar and storm-analysis reflectivity images, and calculation tools cover meteorological calculations, model soundings and ECAPE with CAPE, CIN, LFC, EL and storm motion.

The plugin is Python-first, but heavy paths use Rust binaries or Rust-backed packages: rusbie, wrf-rust, rustweather, metrust, ecape-rs and a radar backend. Missing binaries are built on first use into ~/.hermes/weather/bin, which needs cargo and rustc unless you point to prebuilt ones through environment variables. Radar supports the rustdar backend by default or nexrad, with products such as ref, vel, sw, zdr, rho and phi. Model support is limited to subsets verified for extraction, including gfs, hrrr, nam, gefs, rap and graphcast for model images.

Key features

  • Seven data tools for conditions, forecasts, alerts, METAR, briefs, global weather and severe outlooks
  • wx_model_image for model field PNGs from models such as gfs, hrrr and nam
  • NEXRAD radar and storm images through the rustdar or nexrad backend
  • wx_sounding and wx_ecape for soundings and ECAPE parameters
  • First-use bootstrap that builds Rust binaries into ~/.hermes/weather/bin
  • Environment overrides for prebuilt radar and ECAPE binaries

When to use it

  • Asking Hermes for current conditions, a forecast or active NWS alerts
  • Pulling a radar image or storm analysis during severe weather
  • Running sounding and ECAPE calculations from model profiles

Who it is for: Hermes Agent users, including weather enthusiasts and forecasters, who want weather data and meteorological calculations available to their agent.

How it fits with Hermes Agent

A plugin for Hermes Agent, packaged for Hermes plugin autodiscovery through a Python entry point.

How to install Hermes Weather Plugin

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

pip install git+https://github.com/FahrenheitResearch/hermes-weather-plugin.git

Requirements: Python, and a working Rust toolchain (cargo and rustc) unless you point the plugin at prebuilt binaries.

FAQ

What is Hermes Weather Plugin?

Hermes Weather Plugin is a Hermes Agent plugin that exposes 13 weather tools. They cover observations, forecasts, alerts, model imagery, radar, soundings, calculations and ECAPE.

How do I install Hermes Weather Plugin?

Run pip install git+https://github.com/FahrenheitResearch/hermes-weather-plugin.git and start Hermes normally. Hermes should auto-discover the plugin through its Python entry point.

What do I need to run Hermes Weather Plugin?

You need a Rust toolchain with cargo and rustc, because the plugin builds missing Rust binaries on first use. You can skip that by setting environment variables that point to prebuilt radar and ECAPE binaries.

Similar plugins for Hermes Agent

All plugins

Related guides: How to install Hermes Agent · How to run Hermes Agent securely