Metadata-Version: 2.4
Name: mostlyrightmd-weather
Version: 4.1.0
Summary: Weather data for Python — live METAR (AWC), ASOS archive (IEM), historical observations (GHCNh), and NWS climate text products (CLI). For quants, ML training pipelines, and weather-bot agents. Direct fetches from the public APIs (source addresses resolve through the keyed manifest catalog) with optional hosted satellite delivery. Imports as `mostlyright.weather`.
Project-URL: Homepage, https://mostlyright.md
Project-URL: Documentation, https://mostlyright.md/docs/sdk/
Project-URL: Repository, https://github.com/mostlyrightmd/mostlyright-sdk
Project-URL: Issues, https://github.com/mostlyrightmd/mostlyright-sdk/issues
Project-URL: Changelog, https://github.com/mostlyrightmd/mostlyright-sdk/blob/main/CHANGELOG.md
Author-email: Robert Tarabcak <tarabcakr@gmail.com>
License-Expression: MIT
Keywords: asos,awc,climate-data,forecast,ghcnh,iem,metar,ml-training-data,noaa,nws,nws-cli,observations,time-series,weather,weather-api,weather-bot,weather-data,weather-station
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Requires-Dist: filelock>=3.12
Requires-Dist: httpx>=0.27
Requires-Dist: jsonschema>=4.21
Requires-Dist: mostlyrightmd-core<4.2.0,>=4.1.0
Requires-Dist: pyarrow<24.0,>=17.0
Requires-Dist: tzdata; sys_platform == 'win32'
Provides-Extra: cwop
Requires-Dist: pandas<4.0,>=2.2; extra == 'cwop'
Provides-Extra: nwp
Requires-Dist: cfgrib<1.0,>=0.9.15; extra == 'nwp'
Requires-Dist: pandas<4.0,>=2.2; extra == 'nwp'
Requires-Dist: scikit-learn<2.0,>=1.3; extra == 'nwp'
Requires-Dist: xarray>=2024.0; extra == 'nwp'
Provides-Extra: polars
Requires-Dist: narwhals<2.0,>=1.20; extra == 'polars'
Requires-Dist: pandas<4.0,>=2.2; extra == 'polars'
Requires-Dist: polars<2.0,>=1.0; extra == 'polars'
Requires-Dist: pyarrow<24.0,>=17.0; extra == 'polars'
Provides-Extra: satellite
Requires-Dist: boto3<2.0,>=1.34; extra == 'satellite'
Requires-Dist: eccodes<3.0,>=2.47; extra == 'satellite'
Requires-Dist: eccodeslib<3.0,>=2.48; (platform_system != 'Windows') and extra == 'satellite'
Requires-Dist: eumdac<4.0,>=3.1; extra == 'satellite'
Requires-Dist: fsspec==2026.6.0; extra == 'satellite'
Requires-Dist: gcsfs==2026.6.0; extra == 'satellite'
Requires-Dist: h5netcdf>=1.3; extra == 'satellite'
Requires-Dist: h5py>=3.0; extra == 'satellite'
Requires-Dist: numpy>=1.24; extra == 'satellite'
Requires-Dist: pandas<4.0,>=2.2; extra == 'satellite'
Requires-Dist: s3fs==2026.6.0; extra == 'satellite'
Requires-Dist: xarray>=2024.0; extra == 'satellite'
Description-Content-Type: text/markdown

# mostlyrightmd-weather

Weather data fetchers for the `mostlyright` Python SDK — live METAR (AWC), ASOS archive (IEM), historical observations (GHCNh), and NWS climate text products (CLI) — for quants, ML training pipelines, and weather-bot agents. Data fetches go straight to the public APIs; the addresses they call resolve through the hosted manifest catalog, which requires `MOSTLYRIGHT_API_KEY` (subscriptions at <https://app.mostlyright.md>) — without it every call raises `ApiKeyRequiredError` before making any request. Explicit hosted satellite delivery additionally requires `MOSTLYRIGHT_WEATHER_HOSTED_URL`; the reserved EUMETSAT path requires its consumer credentials. Local parquet cache at `$HOME/.mostlyright/cache/`.

## Install

```bash
pip install mostlyrightmd-weather       # brings mostlyrightmd transitively
```

## Docs

See <https://mostlyright.md/docs/sdk/quickstart-python/> for a 60-second quickstart, or the full API reference at <https://mostlyright.md/docs/sdk/>.
