Metadata-Version: 2.5
Name: earth2studio
Version: 1.0.0
Summary: Open-source deep-learning framework for exploring, building and deploying AI weather/climate workflows.
Project-URL: Homepage, https://github.com/NVIDIA/earth2studio
Project-URL: Documentation, https://nvidia.github.io/earth2studio
Project-URL: Issues, https://github.com/NVIDIA/earth2studio/issues
Project-URL: Changelog, https://github.com/NVIDIA/earth2studio/blob/main/CHANGELOG.md
Author: NVIDIA PhysicsNeMo Team
License-Expression: Apache-2.0
License-File: LICENSE
Classifier: Environment :: GPU
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Typing :: Typed
Requires-Python: <3.15,>=3.11
Requires-Dist: cftime
Requires-Dist: cupy-cuda13x; sys_platform == 'linux' or sys_platform == 'win32'
Requires-Dist: fsspec>=2024.2.0
Requires-Dist: gcsfs
Requires-Dist: h5netcdf>=1.0.0
Requires-Dist: h5py>=3.2.0
Requires-Dist: huggingface-hub>=0.27.0
Requires-Dist: loguru
Requires-Dist: netcdf4<1.7.3,>=1.6.4
Requires-Dist: obspec>=0.1
Requires-Dist: obstore>=0.8
Requires-Dist: pandas
Requires-Dist: pyarrow>=24.0.0
Requires-Dist: pygrib
Requires-Dist: pyproj>=3.7.1
Requires-Dist: python-dotenv
Requires-Dist: rich
Requires-Dist: rmm-cu13>=26.2.0; sys_platform == 'linux'
Requires-Dist: s3fs>=2023.5.0
Requires-Dist: torch>=2.5.0
Requires-Dist: tqdm>=4.65.0
Requires-Dist: xarray[parallel]>=2023.1.0
Requires-Dist: zarr>=3.1.3
Provides-Extra: ace2
Requires-Dist: fme; extra == 'ace2'
Requires-Dist: pandas>=2.3.2; extra == 'ace2'
Requires-Dist: scipy>=1.15.2; extra == 'ace2'
Provides-Extra: aifs
Requires-Dist: anemoi-models==0.5.1; extra == 'aifs'
Requires-Dist: earthkit-regrid==0.4.0; extra == 'aifs'
Requires-Dist: ecmwf-opendata>=0.3.29; extra == 'aifs'
Requires-Dist: flash-attn; extra == 'aifs'
Provides-Extra: aifs2
Requires-Dist: anemoi-models<0.9.5,>=0.9.3; extra == 'aifs2'
Requires-Dist: earthkit-regrid>=0.5.1; extra == 'aifs2'
Requires-Dist: ecmwf-opendata>=0.3.29; extra == 'aifs2'
Requires-Dist: flash-attn; extra == 'aifs2'
Requires-Dist: torch-geometric>=2.6.0; extra == 'aifs2'
Provides-Extra: aifs2ens
Requires-Dist: anemoi-models==0.11.2; extra == 'aifs2ens'
Requires-Dist: earthkit-regrid>=0.5.1; extra == 'aifs2ens'
Requires-Dist: ecmwf-opendata>=0.3.29; extra == 'aifs2ens'
Requires-Dist: flash-attn; extra == 'aifs2ens'
Requires-Dist: torch-geometric>=2.6.0; extra == 'aifs2ens'
Provides-Extra: aifsens
Requires-Dist: anemoi-models==0.5.1; extra == 'aifsens'
Requires-Dist: earthkit-regrid==0.4.0; extra == 'aifsens'
Requires-Dist: ecmwf-opendata>=0.3.29; extra == 'aifsens'
Requires-Dist: flash-attn; extra == 'aifsens'
Provides-Extra: all
Requires-Dist: aiohttp-retry>=2.8.3; extra == 'all'
Requires-Dist: aiohttp>=3.9.0; extra == 'all'
Requires-Dist: arraylake>=1.0.0; (python_version >= '3.12') and extra == 'all'
Requires-Dist: cbottle; (python_full_version >= '3.12') and extra == 'all'
Requires-Dist: cdsapi>=0.7.5; extra == 'all'
Requires-Dist: cfgrib>=0.9.10.3; extra == 'all'
Requires-Dist: climate-learn; extra == 'all'
Requires-Dist: cucim-cu13>=25.4.0; extra == 'all'
Requires-Dist: cudf-cu13>=26.2.0; extra == 'all'
Requires-Dist: cupy-cuda13x; extra == 'all'
Requires-Dist: dm-haiku>=0.0.14; extra == 'all'
Requires-Dist: dm-tree>=0.1.9; extra == 'all'
Requires-Dist: earth2bufr>=0.1.1; extra == 'all'
Requires-Dist: earth2grid; extra == 'all'
Requires-Dist: eccodes>=2.39.2; extra == 'all'
Requires-Dist: eccodeslib>=2.39.2; extra == 'all'
Requires-Dist: ecmwf-opendata>=0.3.29; extra == 'all'
Requires-Dist: einops; extra == 'all'
Requires-Dist: einops>=0.8.1; extra == 'all'
Requires-Dist: eumdac>=3.1.0; extra == 'all'
Requires-Dist: flax>=0.10.6; extra == 'all'
Requires-Dist: gribberish>=1.5.0; (python_version >= '3.12') and extra == 'all'
Requires-Dist: healda; extra == 'all'
Requires-Dist: hydra-core>=1.3.2; extra == 'all'
Requires-Dist: icechunk>=2.0.0; (python_version >= '3.12') and extra == 'all'
Requires-Dist: importlib-metadata; extra == 'all'
Requires-Dist: intake-esgf>=2026.1.26; (python_version >= '3.12') and extra == 'all'
Requires-Dist: jax[cuda13]>=0.4.26; extra == 'all'
Requires-Dist: makani; extra == 'all'
Requires-Dist: microsoft-aurora>=2.0.0; extra == 'all'
Requires-Dist: moviepy; extra == 'all'
Requires-Dist: natten; (python_version < '3.14') and extra == 'all'
Requires-Dist: nvidia-physicsnemo>=1.0.1; extra == 'all'
Requires-Dist: nvidia-physicsnemo>=1.3.0; extra == 'all'
Requires-Dist: nvidia-physicsnemo>=2.0; extra == 'all'
Requires-Dist: nvidia-physicsnemo>=2.0; (python_version < '3.14') and extra == 'all'
Requires-Dist: nvidia-physicsnemo>=2.2.0; extra == 'all'
Requires-Dist: nvidia-physicsnemo>=2.2.0a0; extra == 'all'
Requires-Dist: nvidia-physicsnemo>=2.2.2; extra == 'all'
Requires-Dist: nvtx>=0.2.11; extra == 'all'
Requires-Dist: omegaconf>=2.3.0; extra == 'all'
Requires-Dist: onnx; extra == 'all'
Requires-Dist: onnxruntime-gpu>=1.27.0; extra == 'all'
Requires-Dist: onnxscript; extra == 'all'
Requires-Dist: pcodec>=1.0.2; (python_version >= '3.12') and extra == 'all'
Requires-Dist: pynvml>=12.0.0; extra == 'all'
Requires-Dist: pyproj>=3.7.1; extra == 'all'
Requires-Dist: pystac-client>=0.9.0; extra == 'all'
Requires-Dist: rasterio>=1.3.9; extra == 'all'
Requires-Dist: rioxarray>=0.15.5; extra == 'all'
Requires-Dist: ruamel-yaml>=0.18.10; extra == 'all'
Requires-Dist: ruamel-yaml>=0.18.14; extra == 'all'
Requires-Dist: scikit-image>=0.25.2; extra == 'all'
Requires-Dist: scipy>=1.10.0; extra == 'all'
Requires-Dist: scipy>=1.15.2; extra == 'all'
Requires-Dist: timm; extra == 'all'
Requires-Dist: torch-harmonics; extra == 'all'
Requires-Dist: torch-harmonics>=0.7.4; extra == 'all'
Requires-Dist: torch-harmonics>=0.8.0; extra == 'all'
Requires-Dist: weathermesh-5c[windborne]; extra == 'all'
Requires-Dist: weathernext; (python_version >= '3.12') and extra == 'all'
Provides-Extra: atlas
Requires-Dist: einops; extra == 'atlas'
Requires-Dist: natten; (python_version < '3.14') and extra == 'atlas'
Requires-Dist: nvidia-physicsnemo>=1.3.0; extra == 'atlas'
Requires-Dist: timm; extra == 'atlas'
Requires-Dist: torch-harmonics; extra == 'atlas'
Provides-Extra: aurora
Requires-Dist: microsoft-aurora>=2.0.0; extra == 'aurora'
Provides-Extra: camulator
Provides-Extra: cbottle
Requires-Dist: cbottle; (python_full_version >= '3.12') and extra == 'cbottle'
Requires-Dist: earth2grid; extra == 'cbottle'
Provides-Extra: climatenet
Provides-Extra: corrdiff
Requires-Dist: einops>=0.8.1; extra == 'corrdiff'
Requires-Dist: nvidia-physicsnemo>=2.0; extra == 'corrdiff'
Requires-Dist: nvtx>=0.2.11; extra == 'corrdiff'
Requires-Dist: scipy>=1.15.2; extra == 'corrdiff'
Provides-Extra: corrdiff-era5-hrrr
Requires-Dist: natten; (python_version < '3.14') and extra == 'corrdiff-era5-hrrr'
Requires-Dist: nvidia-physicsnemo>=2.2.0a0; extra == 'corrdiff-era5-hrrr'
Requires-Dist: nvtx>=0.2.11; extra == 'corrdiff-era5-hrrr'
Provides-Extra: cosmo
Requires-Dist: einops>=0.8.1; extra == 'cosmo'
Requires-Dist: natten; (python_version < '3.14') and extra == 'cosmo'
Requires-Dist: nvidia-physicsnemo>=2.2.0; extra == 'cosmo'
Requires-Dist: nvtx>=0.2.11; extra == 'cosmo'
Requires-Dist: scipy>=1.15.2; extra == 'cosmo'
Provides-Extra: cyclone
Requires-Dist: cucim-cu13>=25.4.0; extra == 'cyclone'
Requires-Dist: cupy-cuda13x; extra == 'cyclone'
Requires-Dist: scikit-image>=0.25.2; extra == 'cyclone'
Provides-Extra: da-aida
Requires-Dist: aiohttp-retry>=2.8.3; extra == 'da-aida'
Requires-Dist: aiohttp>=3.9.0; extra == 'da-aida'
Requires-Dist: arraylake>=1.0.0; (python_version >= '3.12') and extra == 'da-aida'
Requires-Dist: cdsapi>=0.7.5; extra == 'da-aida'
Requires-Dist: cfgrib>=0.9.10.3; extra == 'da-aida'
Requires-Dist: cudf-cu13>=26.2.0; extra == 'da-aida'
Requires-Dist: earth2bufr>=0.1.1; extra == 'da-aida'
Requires-Dist: eccodes>=2.39.2; extra == 'da-aida'
Requires-Dist: eccodeslib>=2.39.2; extra == 'da-aida'
Requires-Dist: ecmwf-opendata>=0.3.29; extra == 'da-aida'
Requires-Dist: eumdac>=3.1.0; extra == 'da-aida'
Requires-Dist: gribberish>=1.5.0; (python_version >= '3.12') and extra == 'da-aida'
Requires-Dist: icechunk>=2.0.0; (python_version >= '3.12') and extra == 'da-aida'
Requires-Dist: intake-esgf>=2026.1.26; (python_version >= '3.12') and extra == 'da-aida'
Requires-Dist: pcodec>=1.0.2; (python_version >= '3.12') and extra == 'da-aida'
Requires-Dist: pystac-client>=0.9.0; extra == 'da-aida'
Requires-Dist: rasterio>=1.3.9; extra == 'da-aida'
Requires-Dist: rioxarray>=0.15.5; extra == 'da-aida'
Requires-Dist: scipy>=1.15.2; extra == 'da-aida'
Requires-Dist: weathermesh-5c[windborne]; extra == 'da-aida'
Provides-Extra: da-cosmo
Requires-Dist: cupy-cuda13x; extra == 'da-cosmo'
Requires-Dist: einops>=0.8.1; extra == 'da-cosmo'
Requires-Dist: natten; (python_version < '3.14') and extra == 'da-cosmo'
Requires-Dist: nvidia-physicsnemo>=2.2.0; extra == 'da-cosmo'
Requires-Dist: nvtx>=0.2.11; extra == 'da-cosmo'
Requires-Dist: scipy>=1.15.2; extra == 'da-cosmo'
Provides-Extra: da-healda
Requires-Dist: cudf-cu13>=26.2.0; extra == 'da-healda'
Requires-Dist: cupy-cuda13x; extra == 'da-healda'
Requires-Dist: earth2grid; extra == 'da-healda'
Requires-Dist: nvidia-physicsnemo>=2.0; (python_version < '3.14') and extra == 'da-healda'
Provides-Extra: da-healda-v2
Requires-Dist: cudf-cu13>=26.2.0; extra == 'da-healda-v2'
Requires-Dist: cupy-cuda13x; extra == 'da-healda-v2'
Requires-Dist: earth2grid; extra == 'da-healda-v2'
Requires-Dist: healda; extra == 'da-healda-v2'
Provides-Extra: da-interp
Requires-Dist: cudf-cu13>=26.2.0; extra == 'da-interp'
Requires-Dist: cupy-cuda13x; extra == 'da-interp'
Provides-Extra: da-stormcast
Requires-Dist: cudf-cu13>=26.2.0; extra == 'da-stormcast'
Requires-Dist: cupy-cuda13x; extra == 'da-stormcast'
Requires-Dist: einops>=0.8.1; extra == 'da-stormcast'
Requires-Dist: nvidia-physicsnemo>=2.0; extra == 'da-stormcast'
Requires-Dist: nvtx>=0.2.11; extra == 'da-stormcast'
Requires-Dist: omegaconf>=2.3.0; extra == 'da-stormcast'
Requires-Dist: pyproj>=3.7.1; extra == 'da-stormcast'
Requires-Dist: scipy>=1.15.2; extra == 'da-stormcast'
Provides-Extra: data
Requires-Dist: aiohttp-retry>=2.8.3; extra == 'data'
Requires-Dist: aiohttp>=3.9.0; extra == 'data'
Requires-Dist: arraylake>=1.0.0; (python_version >= '3.12') and extra == 'data'
Requires-Dist: cdsapi>=0.7.5; extra == 'data'
Requires-Dist: cfgrib>=0.9.10.3; extra == 'data'
Requires-Dist: earth2bufr>=0.1.1; extra == 'data'
Requires-Dist: eccodes>=2.39.2; extra == 'data'
Requires-Dist: eccodeslib>=2.39.2; extra == 'data'
Requires-Dist: ecmwf-opendata>=0.3.29; extra == 'data'
Requires-Dist: eumdac>=3.1.0; extra == 'data'
Requires-Dist: gribberish>=1.5.0; (python_version >= '3.12') and extra == 'data'
Requires-Dist: icechunk>=2.0.0; (python_version >= '3.12') and extra == 'data'
Requires-Dist: intake-esgf>=2026.1.26; (python_version >= '3.12') and extra == 'data'
Requires-Dist: pcodec>=1.0.2; (python_version >= '3.12') and extra == 'data'
Requires-Dist: pystac-client>=0.9.0; extra == 'data'
Requires-Dist: rasterio>=1.3.9; extra == 'data'
Requires-Dist: rioxarray>=0.15.5; extra == 'data'
Requires-Dist: scipy>=1.15.2; extra == 'data'
Provides-Extra: derived
Provides-Extra: dlesym
Requires-Dist: earth2grid; extra == 'dlesym'
Requires-Dist: hydra-core>=1.3.2; extra == 'dlesym'
Requires-Dist: nvidia-physicsnemo>=2.2.0a0; extra == 'dlesym'
Requires-Dist: omegaconf>=2.3.0; extra == 'dlesym'
Provides-Extra: dlwp
Requires-Dist: importlib-metadata; extra == 'dlwp'
Requires-Dist: nvidia-physicsnemo>=1.0.1; extra == 'dlwp'
Provides-Extra: fcn
Requires-Dist: nvidia-physicsnemo>=1.0.1; extra == 'fcn'
Provides-Extra: fcn3
Requires-Dist: makani; extra == 'fcn3'
Requires-Dist: moviepy; extra == 'fcn3'
Requires-Dist: ruamel-yaml>=0.18.14; extra == 'fcn3'
Requires-Dist: scipy>=1.10.0; extra == 'fcn3'
Requires-Dist: torch-harmonics>=0.8.0; extra == 'fcn3'
Provides-Extra: fengwu
Requires-Dist: onnx; extra == 'fengwu'
Requires-Dist: onnxruntime-gpu>=1.27.0; extra == 'fengwu'
Requires-Dist: onnxscript; extra == 'fengwu'
Provides-Extra: fuxi
Requires-Dist: onnx; extra == 'fuxi'
Requires-Dist: onnxruntime-gpu>=1.27.0; extra == 'fuxi'
Requires-Dist: onnxscript; extra == 'fuxi'
Provides-Extra: gencast
Requires-Dist: dm-haiku>=0.0.14; extra == 'gencast'
Requires-Dist: dm-tree>=0.1.9; extra == 'gencast'
Requires-Dist: flax>=0.10.6; extra == 'gencast'
Requires-Dist: jax[cuda13]>=0.4.26; extra == 'gencast'
Requires-Dist: weathernext; (python_version >= '3.12') and extra == 'gencast'
Provides-Extra: graphcast
Requires-Dist: dm-haiku>=0.0.14; extra == 'graphcast'
Requires-Dist: dm-tree>=0.1.9; extra == 'graphcast'
Requires-Dist: flax>=0.10.6; extra == 'graphcast'
Requires-Dist: jax[cuda13]>=0.4.26; extra == 'graphcast'
Requires-Dist: weathernext; (python_version >= '3.12') and extra == 'graphcast'
Provides-Extra: interp-crps-dit
Requires-Dist: natten; (python_version < '3.14') and extra == 'interp-crps-dit'
Requires-Dist: nvidia-physicsnemo>=2.2.0; extra == 'interp-crps-dit'
Provides-Extra: interp-modafno
Requires-Dist: nvidia-physicsnemo>=2.0; extra == 'interp-modafno'
Provides-Extra: orbit
Requires-Dist: climate-learn; extra == 'orbit'
Provides-Extra: pangu
Requires-Dist: onnx; extra == 'pangu'
Requires-Dist: onnxruntime-gpu>=1.27.0; extra == 'pangu'
Requires-Dist: onnxscript; extra == 'pangu'
Provides-Extra: perturbation
Requires-Dist: scipy>=1.15.2; extra == 'perturbation'
Requires-Dist: torch-harmonics>=0.7.4; extra == 'perturbation'
Provides-Extra: precip-afno
Requires-Dist: nvidia-physicsnemo>=1.0.1; extra == 'precip-afno'
Provides-Extra: precip-afno-v2
Requires-Dist: nvidia-physicsnemo>=1.0.1; extra == 'precip-afno-v2'
Provides-Extra: samudrace
Requires-Dist: fme==2026.4.0; extra == 'samudrace'
Requires-Dist: pandas>=2.3.2; extra == 'samudrace'
Requires-Dist: scipy>=1.15.2; extra == 'samudrace'
Requires-Dist: xarray>=2025.1.0; extra == 'samudrace'
Provides-Extra: sfno
Requires-Dist: makani; extra == 'sfno'
Requires-Dist: moviepy; extra == 'sfno'
Requires-Dist: pynvml>=12.0.0; extra == 'sfno'
Requires-Dist: ruamel-yaml>=0.18.10; extra == 'sfno'
Requires-Dist: scipy>=1.10.0; extra == 'sfno'
Requires-Dist: torch-harmonics>=0.8.0; extra == 'sfno'
Provides-Extra: solarradiation-afno
Requires-Dist: nvidia-physicsnemo>=1.0.1; extra == 'solarradiation-afno'
Provides-Extra: statistics
Requires-Dist: nvidia-physicsnemo>=1.0.1; extra == 'statistics'
Provides-Extra: stormcast
Requires-Dist: einops>=0.8.1; extra == 'stormcast'
Requires-Dist: nvidia-physicsnemo>=2.0; extra == 'stormcast'
Requires-Dist: nvtx>=0.2.11; extra == 'stormcast'
Requires-Dist: omegaconf>=2.3.0; extra == 'stormcast'
Requires-Dist: pyproj>=3.7.1; extra == 'stormcast'
Requires-Dist: scipy>=1.15.2; extra == 'stormcast'
Provides-Extra: stormcast-conus
Requires-Dist: natten; (python_version < '3.14') and extra == 'stormcast-conus'
Requires-Dist: nvidia-physicsnemo>=2.2.0; extra == 'stormcast-conus'
Requires-Dist: nvtx>=0.2.11; extra == 'stormcast-conus'
Requires-Dist: omegaconf>=2.3.0; extra == 'stormcast-conus'
Requires-Dist: scipy>=1.15.2; extra == 'stormcast-conus'
Provides-Extra: stormscope
Requires-Dist: earth2grid; extra == 'stormscope'
Requires-Dist: natten; (python_version < '3.14') and extra == 'stormscope'
Requires-Dist: nvidia-physicsnemo>=2.2.2; extra == 'stormscope'
Requires-Dist: nvtx>=0.2.11; extra == 'stormscope'
Requires-Dist: omegaconf>=2.3.0; extra == 'stormscope'
Requires-Dist: scipy>=1.15.2; extra == 'stormscope'
Provides-Extra: ucast
Provides-Extra: utils
Requires-Dist: earth2grid; extra == 'utils'
Requires-Dist: scipy>=1.15.2; extra == 'utils'
Provides-Extra: weathermesh5c
Requires-Dist: aiohttp-retry>=2.8.3; extra == 'weathermesh5c'
Requires-Dist: aiohttp>=3.9.0; extra == 'weathermesh5c'
Requires-Dist: arraylake>=1.0.0; (python_version >= '3.12') and extra == 'weathermesh5c'
Requires-Dist: cdsapi>=0.7.5; extra == 'weathermesh5c'
Requires-Dist: cfgrib>=0.9.10.3; extra == 'weathermesh5c'
Requires-Dist: earth2bufr>=0.1.1; extra == 'weathermesh5c'
Requires-Dist: eccodes>=2.39.2; extra == 'weathermesh5c'
Requires-Dist: eccodeslib>=2.39.2; extra == 'weathermesh5c'
Requires-Dist: ecmwf-opendata>=0.3.29; extra == 'weathermesh5c'
Requires-Dist: eumdac>=3.1.0; extra == 'weathermesh5c'
Requires-Dist: gribberish>=1.5.0; (python_version >= '3.12') and extra == 'weathermesh5c'
Requires-Dist: icechunk>=2.0.0; (python_version >= '3.12') and extra == 'weathermesh5c'
Requires-Dist: intake-esgf>=2026.1.26; (python_version >= '3.12') and extra == 'weathermesh5c'
Requires-Dist: pcodec>=1.0.2; (python_version >= '3.12') and extra == 'weathermesh5c'
Requires-Dist: pystac-client>=0.9.0; extra == 'weathermesh5c'
Requires-Dist: rasterio>=1.3.9; extra == 'weathermesh5c'
Requires-Dist: rioxarray>=0.15.5; extra == 'weathermesh5c'
Requires-Dist: scipy>=1.15.2; extra == 'weathermesh5c'
Requires-Dist: weathermesh-5c[windborne]; extra == 'weathermesh5c'
Provides-Extra: weathernext
Requires-Dist: dm-haiku>=0.0.14; extra == 'weathernext'
Requires-Dist: dm-tree>=0.1.9; extra == 'weathernext'
Requires-Dist: flax>=0.10.6; extra == 'weathernext'
Requires-Dist: jax[cuda13]>=0.4.26; extra == 'weathernext'
Requires-Dist: weathernext; (python_version >= '3.12') and extra == 'weathernext'
Provides-Extra: windgust-afno
Requires-Dist: nvidia-physicsnemo>=1.0.1; extra == 'windgust-afno'
Description-Content-Type: text/markdown

<!-- markdownlint-disable MD033 MD041 -->

> [!IMPORTANT]
> **1.0.0**: This is a major release with breaking changes from pre-1.0 releases.
> See the [migration guide](https://github.com/NVIDIA/earth2studio/blob/main/MIGRATION.md)
> if you need help transitioning, or point your agent to it.
> To install the legacy version, please refer to the
> [0.20.0 installation instructions](https://nvidia.github.io/earth2studio/0.20.0/userguide/about/install/).

<div align="center">

# NVIDIA Earth2Studio

**Next-generation AI weather and climate modeling.**

[![python version][e2studio_python_img]][e2studio_python_url]
[![license][e2studio_license_img]][e2studio_license_url]
![Maturity: L3 Strategic][e2studio_maturity_img]
[![coverage][e2studio_cov_img]][e2studio_cov_url]
[![uv][e2studio_uv_img]][e2studio_uv_url]

[Install][e2studio_install_url] | [User Guide][e2studio_userguide_url] |
[Examples][e2studio_examples_url] | [API][e2studio_api_url] |
[Skills](./skills)

</div>

Access a leading collection of weather and climate AI models, production-ready data sources,
composable inference APIs, and GPU-accelerated workflows in one Python package.

![Earth2Studio hero][e2studio_hero_img]

## Get Started

Paste this into your coding agent (Claude, Codex, OpenCode, Cursor, etc.):

```text
Help me get started with Earth2Studio.
https://github.com/NVIDIA/earth2studio
```

[`AGENTS.md`](./AGENTS.md) routes usage and development tasks to the relevant
documentation and skills. Learn more, install, and start forecasting with just a few prompts:

```text
# Learn about the latest release
Summarize new models and features in the latest Earth2Studio release.
Include the version, release date, and links to the release notes.

# Create a forecasting pipeline
Create a 10-day AI forecasting pipeline starting from the latest GFS analysis.

# Set up a Python environment for a specific model
Set up my environment for FourCastNet3 inference.

# Find a model for your forecast and hardware
Recommend the best model for a 2-week global forecast on one GPU.

# Explore models that predict a specific product
What models do you have that support predicting precipitation?

# Download weather data
Fetch ERA5 surface winds for March 2024 and save them to Zarr.
```

To keep the skills installed, add them from this repository:

```bash
npx skills add NVIDIA/earth2studio --skill earth2studio-install
npx skills add NVIDIA/earth2studio --skill earth2studio-discover
```

## Installation and Examples

Each model has different dependencies; the install guide provides the exact commands for your setup.

| Resource | What's there |
| --- | --- |
| [**Install**][e2studio_install_url] | Environments, model-specific extras, hardware |
| [**Examples**][e2studio_examples_url] | Deterministic, ensemble, diagnostic and coupled workflows |
| [**User Guide**][e2studio_userguide_url] | Components, design philosophy and extending the package |
| [**API**][e2studio_api_url] | Every [prognostic][e2studio_px_api], [diagnostic][e2studio_dx_api] and [data source][e2studio_data_api] |

## Main Features

- [**Forecast**][e2studio_px_api] with global and regional prognostic AI models.
- [**Diagnose**][e2studio_dx_api] derived fields such as precipitation, wind speed and downscaled output.
- [**Assimilate**][e2studio_da_api] sparse observations into global and regional analyses.
- [**Fetch**][e2studio_data_api] analysis, forecast and observation data from public sources.
- [**Compose**][e2studio_examples_url] ensembles and coupled multi-model workflows.
- [**Store**][e2studio_io_api] results to Zarr, NetCDF and more.

## Documentation

Everything else (model zoo, data sources, news, tutorials) lives on the
[documentation site][e2studio_docs_url]. See the [changelog](./CHANGELOG.md) for what
is new, [CONTRIBUTING](./CONTRIBUTING.md) to get involved, and
[Earth-2 Open Models](https://huggingface.co/collections/nvidia/earth-2) for NVIDIA's
open weights and [PhysicsNeMo][physicsnemo_repo_url] for training recipes.
For deploying workflows as an inference service, see
[PhysicsNeMo Serve](https://github.com/NVIDIA/physicsnemo-serve).

> [!WARNING]
> NOTICE AND DISCLAIMER: This software automatically retrieves, accesses or interacts with
> external materials. Those retrieved materials are not distributed with this software and
> are governed solely by separate terms, conditions and licenses. You are solely responsible
> for finding, reviewing and complying with all applicable terms, conditions, and licenses,
> and for verifying the security, integrity and suitability of any retrieved materials for
> your specific use case. This software is provided "AS IS", without warranty of any kind.
> The author makes no representations or warranties regarding any retrieved materials, and
> assumes no liability for any losses, damages, liabilities or legal consequences from your
> use or inability to use this software or any retrieved materials. Use this software and
> the retrieved materials at your own risk.

## License

Apache License 2.0, see the [LICENSE file][e2studio_license_url].

<!-- Badge links -->

[e2studio_python_img]: https://img.shields.io/badge/Python-3.11%20|%203.12%20|%203.13%20|%203.14-blue?style=flat-square&logo=python
[e2studio_license_img]: https://img.shields.io/badge/License-Apache%202.0-green?style=flat-square
[e2studio_maturity_img]: https://img.shields.io/badge/Maturity-L3%20Strategic-CB4B16?style=flat-square
[e2studio_cov_img]: https://img.shields.io/codecov/c/github/nvidia/earth2studio?style=flat-square&logo=codecov
[e2studio_uv_img]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fastral-sh%2Fuv%2Fmain%2Fassets%2Fbadge%2Fv0.json&style=flat-square

[e2studio_python_url]: https://www.python.org/downloads/
[e2studio_license_url]: ./LICENSE
[e2studio_cov_url]: ./test/
[e2studio_uv_url]: https://github.com/astral-sh/uv

<!-- Doc links -->
[e2studio_docs_url]: https://nvidia.github.io/earth2studio/
[e2studio_install_url]: https://nvidia.github.io/earth2studio/main/userguide/about/install/
[e2studio_userguide_url]: https://nvidia.github.io/earth2studio/main/userguide/
[e2studio_examples_url]: https://nvidia.github.io/earth2studio/main/examples/
[e2studio_api_url]: https://nvidia.github.io/earth2studio/main/modules/
[e2studio_px_api]: https://nvidia.github.io/earth2studio/main/modules/models_px/
[e2studio_dx_api]: https://nvidia.github.io/earth2studio/main/modules/models_dx/
[e2studio_da_api]: https://nvidia.github.io/earth2studio/main/modules/models_da/
[e2studio_io_api]: https://nvidia.github.io/earth2studio/main/modules/io/
[e2studio_data_api]: https://nvidia.github.io/earth2studio/main/modules/datasources_analysis/

<!-- Misc links -->
[physicsnemo_repo_url]: https://github.com/NVIDIA/physicsnemo
[e2studio_hero_img]: https://huggingface.co/datasets/nvidia/earth2studio-assets/resolve/8c62745bdb3ebbe008242e56a2b9bf08463f96a7/readme/earth2studio_hero_image.png
