2025.11.0

Release date: November 7, 2025
Full Changelog: 2025.10.0...2025.11.0

What's Changed

We updated the versions of fme dependencies torch-harmonics (0.7.4 --> 0.8.0) and imageio(<2.27.0 --> >2.28.1) based on user feedback.

2025.10.0

Release date: October 16, 2025
Full Changelog: 2025.7.0...2025.10.0

What's Changed

This release includes the capability to run coupled models (such as those emulating the atmosphere, ocean, and sea ice!) via entrypoints in fme.coupled. We have provided documentation for running inference using coupled model weights.

The deprecated legacy training configuration format (SingleModuleStepperConfig) has been removed in this release. However, breaking changes have been avoided and backwards compatibility has been maintained with existing saved models for most cases.

2025.7.0

What's Changed

This release includes major internal refactors and improved documentation. The previous training configuration format has been deprecated and will be removed in a future release. However, breaking changes have been avoided and backwards compatibility has been maintained with existing saved models for most cases.

Version updates:

• Python 3.11 and torch 2.7.1

Internal refactors:

• The fme package has been moved one level up (i.e., away from the legacy fme/fme/... layout and to fme/ace/ and fme/core/ instead).

Increased modularity for ML emulation:

• Training configuration is now based around a more flexible StepperConfig; the legacy SingleModuleStepperConfig is deprecated and will be removed in a future release.
• The stepper config now supports the modular step framework allowing composible steps for ML emulation.

Experimental features:

• Samudra, a global ocean emulator developed by M2LInES, is now fully integrated into Ai2's full model framework. An example production workflow for training and running Samudra is currently under development and will be included in the upcoming release.

Documentation

• Added an improved quickstart.rst focused around the models saved in our Hugging Face collection.

Full Changelog: 2024.12.0...2025.7.0

2024.12.0

What's Changed

This release contains many internal changes for ACE code. However, all configuration options accessible by the entrypoints of the fme package (i.e. fme.ace.train, fme.ace.inference and fme.ace.evaluator) have had no breaking changes.

The following lists are not complete but just a highlight of changes which may be relevant to users.

Bug fixes:

• resolved transient bug that sometimes occurred in XarrayDataset when trying to read the image shape from a scalar field
• when using n_repeats greater than 1, XarrayDataset now correctly increments the values in the returned time arrays

New features:

• ACE works on Apple Silicon! Set the environmental variable FME_USE_MPS=1 to use the pytorch MPS backend. Make sure to have the latest version of pytorch installed. This gives about a 5x speed up over running on CPU (tested on a Macbook Pro M3 Max).
• add perturbations to sea surface temperature during inference (see ForcingDataLoaderConfig.perturbations)

Refactors:

• deduplicated some inference code by using generics. Now the fme.ace.inference and fme.ace.evaluator entrypoints now share more code.

Full Changelog: 2024.9.0...2024.12.0

2024.9.0

What's Changed

• Update README to link to zenodo repo with checkpoint by @oliverwm1 in #3
• New public release of FME code by @oliverwm1 in #5
• Fix instruction for installing from GitHub by @oliverwm1 in #7
• Add readthedocs config by @mcgibbon in #6
• Add docs badge and link by @oliverwm1 in #8
• Add link to zenodo archive with checkpoint by @oliverwm1 in #9
• Add link to E3SMv2-trained paper and checkpoint by @oliverwm1 in #12
• Add link to published EAMv2 paper in JGR-ML by @jpdunc23 in #16
• Add missing init files by @oliverwm1 in #17
• Update for PyPI release by @frodre in #20

New Contributors

• @oliverwm1 made their first contribution in #3
• @mcgibbon made their first contribution in #6
• @jpdunc23 made their first contribution in #16
• @frodre made their first contribution in #20

Full Changelog: 2023.12.0...2024.9.0

2023.12.0

Inference code for model described in https://arxiv.org/abs/2310.02074