{"id":45094,"library":"herbie-data","title":"Herbie","description":"Herbie is a Python library for downloading and reading numerical weather prediction (NWP) model data in GRIB2 format. It provides a unified interface to access high-resolution weather data from sources like HRRR, RAP, GFS, and others. The current version is 2026.3.0, with a regular release cadence (monthly).","status":"active","version":"2026.3.0","language":"python","source_language":"en","source_url":"https://github.com/blaylockbk/Herbie","tags":["weather","grib","nwp","meteorology","data-download"],"install":[{"cmd":"pip install herbie-data","lang":"bash","label":"Install via pip"}],"dependencies":[{"reason":"Required for reading GRIB2 files","package":"cfgrib","optional":false},{"note":"System-level dependency; can use cfgrib's bundled ecCodes instead","reason":"ECMWF ecCodes library for GRIB2 decoding","package":"eccodes","optional":true},{"reason":"HTTP requests to download data","package":"requests","optional":false}],"imports":[{"note":"Old package name was 'herbie-data' but the import is 'herbie'","wrong":"from herbie_data import Herbie","symbol":"Herbie","correct":"from herbie import Herbie"},{"symbol":"fastHerbie","correct":"from herbie import fastHerbie"}],"quickstart":{"code":"from herbie import Herbie\n\n# Download HRRR temperature data for a specific time\nH = Herbie('2022-01-01', model='hrrr', product='sfc', fxx=0)\nH.download()\nds = H.xarray('TMP:2 m')\nprint(ds['t2m'])\n","lang":"python","description":"This example downloads the 2-meter temperature field from the HRRR model for January 1, 2022."},"warnings":[{"fix":"Set the environment variable HERBIE_DATA_DIR before creating a Herbie object.","message":"The default data directory is $HOME/data. If you don't set HERBIE_DATA_DIR, downloads go to your home directory. Use os.environ['HERBIE_DATA_DIR'] = '/path/to/data' to change it.","severity":"gotcha","affected_versions":"all"},{"fix":"Use the .xarray() method with the field name as a string.","message":"Version 2024.x changed the internal API for accessing GRIB2 fields. The old method Herbie['TMP:2 m'] no longer works; use Herbie.xarray('TMP:2 m') instead.","severity":"breaking","affected_versions":">=2024.0.0"},{"fix":"Pass the correct product string, e.g., product='pgrb2b.0p25' for GFS 0.25 deg.","message":"Some models (e.g., GFS) require specifying the 'product' argument. If omitted, Herbie may fail with a vague error. Always consult the model's documentation for valid product names.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'2026.3.0':44 'access':26 'cadenc':49 'current':41 'data':16,31,56 'data-download':55 'download':8,57 'format':19 'gfs':37 'grib':52 'grib2':18 'herbi':1,2 'high':28 'high-resolut':27 'hrrr':35 'interfac':24 'librari':6 'like':34 'meteorolog':54 'model':15 'month':50 'numer':11 'nwp':14,53 'other':39 'predict':13 'provid':21 'python':5 'rap':36 'read':10 'regular':47 'releas':48 'resolut':29 'sourc':33 'unifi':23 'version':42 'weather':12,30,51","created_at":"2026-06-07T12:53:19.686643+00:00","updated_at":"2026-06-07T12:53:19.686643+00:00","problems":[{"fix":"pip install herbie-data and then use 'from herbie import Herbie'.","cause":"The package is installed as 'herbie-data' but imported as 'herbie'.","error":"ModuleNotFoundError: No module named 'herbie'"},{"fix":"List available fields with H.inventory() and check the exact parameter name.","cause":"The GRIB2 field name might be different or the product does not contain that variable.","error":"KeyError: 'TMP:2 m'"},{"fix":"Use the exact model name: model='GFS'.","cause":"Model names are case-sensitive. 'gfs' should be 'GFS'.","error":"ValueError: unknown model 'gfs'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/blaylockbk/Herbie","github":"https://github.com/blaylockbk/Herbie","docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-29","install_tag":null}}