Skip to main content

ace-jax

PyPI Docs Tests License: MIT

Build, fit and evaluate Atomic Cluster Expansion (ACE) interatomic potentials in Python with JAX, on CPU or GPU. One pip install gives all of these functions.

Documentation: https://acesuit.github.io/ace-jax/. It contains the installation, a quickstart, tutorials, how-to guides, and the CLI and API reference.

What it does

  • Build a basis and fit it with one command. aj fit --order 3 --max-degree 10 --train train.xyz --out fit builds the symmetry-adapted ACE basis and fits it. The fit.yaml file that it writes runs the fit again.
  • Bayesian fits. Linear ACE uses Bayesian linear regression. The fit selects the energy, force and virial noise levels and the prior scale by maximising the evidence, so you do not set weights by hand.
    • An experimental hybrid ACE + Gaussian-process model (--m-per-species > 0) adds a calibrated set of uncertainty approximations (MAP, Laplace, Pathfinder, VI, NUTS). Most fits use the linear model, the default.
    • The linear model has POPS and ARD uncertainties.
    • ARD gives a conformally calibrated per-atom force uncertainty (forces_std, forces_q, a 3x3 forces_cov). aj calibrate recalibrates it on new labelled cells.
    • The fit can also learn the radial basis (--learn-radial).
  • Fast evaluation. ACECalculator and GPCalculator are ASE calculators, fast enough for molecular dynamics. GP and ARD models also predict energy_std and forces_std. export_lammps deploys a model to LAMMPS with lammps-jax. On CPUs, linear ACE runs in LAMMPS as a C++ kernel (aj export --platform cpu).
  • PACE potentials. ace-jax loads, evaluates and writes pacemaker .yace files.
  • Data in, data out. Training data is extended XYZ or a list of ase.Atoms. ace-jax converts stress labels to virials. aj eval writes predictions as extended XYZ, with an RMSE table for each configuration type.

Install

pip install ace-jax

Extras: "ace-jax[cuda]" (CUDA 12 JAX), "ace-jax[cuda13]" (CUDA 13 JAX and nvcc for the GPU kernel; NVIDIA driver 580 or later), "ace-jax[gp]" (the Pathfinder rung), "ace-jax[native]" (C++ code on CPUs: a neighbour list and the kernel), "ace-jax[lammps]" (LAMMPS export with lammps-jax) and "ace-jax[jaxmd]" (MD with JAX-MD).

To build a new basis, ace-jax needs the ace-jax-coupling wheel. This core dependency is available for Linux x86_64 and aarch64, macOS arm64 and Windows x64. On other platforms, fit and evaluate from an existing basis file. See Installation.

Quickstart

Fit a linear ACE model to labelled data, check it on a test set, and evaluate it:

aj fit --order 3 --max-degree 10 --train train.xyz --test test.xyz \
    --e0 lsq --opt lbfgs --out fit
aj eval --model fit/model.npz --data test.xyz --out predictions.xyz

Use the fitted model from Python:

import jax
jax.config.update("jax_enable_x64", True)

from ase.build import bulk
from ace_jax import ACECalculator

atoms = bulk("Si", "diamond", a=5.43, cubic=True)
atoms.calc = ACECalculator("fit/model.npz")
print(atoms.get_potential_energy(), atoms.get_forces())

The Quickstart runs this on a small silicon dataset. The tutorials are notebooks that run on a laptop CPU. Some of them come from the MLIP School 2026. For coding agents, skills/ace-jax/SKILL.md is a compact usage guide.

Performance and validation

Fits agree with the ACEfit design matrix and least-squares solution to 1e-8. PACE evaluation agrees with the ML-PACE C++ code and python-ace. CI checks both.

The Performance page gives the benchmarks. On silicon, it compares the accuracy and the cost of ace-jax with other interatomic potentials in LAMMPS. On a five-element alloy, it compares the speed of ace-jax with ML-PACE and MACE.

Citing

If you use ace-jax in published work, cite these papers:

Cite these papers also, if you use the related functions:

CITATION.cff has the full references. Licence and citation also lists the software and models that ace-jax uses.

Contributing

See CONTRIBUTING.md for the development setup, tests and the reference-parity jobs. See the changelog for releases. ace-jax has the MIT licence and is part of ACEsuit.

Metadata

Release files for ace-jax 0.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ace-jax 0.7.0
File Size Uploaded Provenance Actions
ace_jax-0.7.0.tar.gz 519.4 kB With provenance Details for ace_jax-0.7.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for ace-jax 0.7.0
File Actions
ace_jax-0.7.0-py3-none-manylinux_2_28_x86_64.whl Python 3 none Linux glibc 2.28+ x86-64 Details for ace_jax-0.7.0-py3-none-manylinux_2_28_x86_64.whl
ace_jax-0.7.0-py3-none-manylinux_2_28_aarch64.whl Python 3 none Linux glibc 2.28+ ARM64 Details for ace_jax-0.7.0-py3-none-manylinux_2_28_aarch64.whl
ace_jax-0.7.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for ace_jax-0.7.0-py3-none-macosx_11_0_arm64.whl
ace_jax-0.7.0-py3-none-any.whl Python 3 none any Details for ace_jax-0.7.0-py3-none-any.whl

Total release size: 4.9 MB

Release files / ace_jax-0.7.0.tar.gz

Download URL ace_jax-0.7.0.tar.gz
Size 519.4 kB
Tags Source
SHA-256 checksum
How to use checksums
3ab98e3db67e7ffd5b6a676605d50336c024368ad73e0bb60a12f0ec493c260d
BLAKE2b-256 checksum
How to use checksums
75053af420e2e2ad55e6773ba5572ec97253d2c21a7c8a167dae9c75b1597e0b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / ace_jax-0.7.0-py3-none-manylinux_2_28_x86_64.whl

Download URL ace_jax-0.7.0-py3-none-manylinux_2_28_x86_64.whl
Size 1.9 MB
Tags Linux glibc 2.28+ x86-64 Python 3
SHA-256 checksum
How to use checksums
8e9349827f6fd228ae0c3e025830076915335c1e4c17025226c785d2638800d5
BLAKE2b-256 checksum
How to use checksums
3b2fec44651890d92889d9d6aa43424f0b97d5c753baf2a068c923a6f12fe46e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / ace_jax-0.7.0-py3-none-manylinux_2_28_aarch64.whl

Download URL ace_jax-0.7.0-py3-none-manylinux_2_28_aarch64.whl
Size 1.2 MB
Tags Linux glibc 2.28+ ARM64 Python 3
SHA-256 checksum
How to use checksums
3c0af9f0b77262f0587bbb8aabd3e8f574e998490507602a4895607d4fef1487
BLAKE2b-256 checksum
How to use checksums
661e2e344e03afc212c10eb61105b2107fcab6c999afdd1c5ad35f178c579d41
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / ace_jax-0.7.0-py3-none-macosx_11_0_arm64.whl

Download URL ace_jax-0.7.0-py3-none-macosx_11_0_arm64.whl
Size 645.6 kB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
92e97129688a4c5fbf80ed66a3c6cf11e332b4f69c1bce897eeed54262b85f06
BLAKE2b-256 checksum
How to use checksums
2a412c1e777ca7794c964774de12fa304a92f555f78f0271a614e91ff7b187fa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / ace_jax-0.7.0-py3-none-any.whl

Download URL ace_jax-0.7.0-py3-none-any.whl
Size 594.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b5cc787bff2296a74f63fa5520553adbb3e2c3aead8dd227e54483855dc8546a
BLAKE2b-256 checksum
How to use checksums
230776da6fb5a38a3347122d58c7b6f3b21bc288ae239c90061ca3fb0f289a9d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Security for ace-jax 0.7.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 5 files in this release have been uploaded with provenance metadata.

Select from 5 files

Attestation for ace_jax-0.7.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page