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.2

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.2
File Size Uploaded Provenance Actions
ace_jax-0.7.2.tar.gz 546.2 kB With provenance Details for ace_jax-0.7.2.tar.gz

Built distributions (wheels)

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

Total release size: 5.1 MB

Release files / ace_jax-0.7.2.tar.gz

Download URL ace_jax-0.7.2.tar.gz
Size 546.2 kB
Tags Source
SHA-256 checksum
How to use checksums
bba166133cf30e383d9a09152537a13c75a70817fa1a851c32eb4d764db1a7fb
BLAKE2b-256 checksum
How to use checksums
c6dfb74a05f4e74e026341748fffb0966b529f1779f0d1e46b28c97c32f329be
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 21, 2026.

Transparency log

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

Download URL ace_jax-0.7.2-py3-none-manylinux_2_28_x86_64.whl
Size 2.0 MB
Tags Linux glibc 2.28+ x86-64 Python 3
SHA-256 checksum
How to use checksums
933b241f80a72ac0ec41c2e09960f4f27e0d743f54a8d3eef348238658e60d9a
BLAKE2b-256 checksum
How to use checksums
bb39030e5804813fb2cc03904fe884859417024ea5ce3bb3bb19612eb2854f06
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 21, 2026.

Transparency log

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

Download URL ace_jax-0.7.2-py3-none-manylinux_2_28_aarch64.whl
Size 1.3 MB
Tags Linux glibc 2.28+ ARM64 Python 3
SHA-256 checksum
How to use checksums
352bd66142a101fee7c890300ccf7c8ac1c0e05795f0813bd1ff3768a856a735
BLAKE2b-256 checksum
How to use checksums
a34b8354f3c95ba052ac525d6d49e9786165deae7efbd2b5691c7e72db6a143d
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 21, 2026.

Transparency log

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

Download URL ace_jax-0.7.2-py3-none-macosx_11_0_arm64.whl
Size 680.1 kB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
497ab9793fb752ab712d35a021f798826dea6207f3be9489b06002e75ddd58dd
BLAKE2b-256 checksum
How to use checksums
fcc1f14237831c18008212f18fb7cb7eb19c3704e0c1b9ec066ef57e2bceaed2
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 21, 2026.

Transparency log

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

Download URL ace_jax-0.7.2-py3-none-any.whl
Size 621.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a1efc21c80871decbe3f49c00b52d92eac42921e88247f97a404408331ff764d
BLAKE2b-256 checksum
How to use checksums
1d16041b4f75c5939e4083ff16b62381186904eae94022b1dc2ffe7d4bead83f
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 21, 2026.

Transparency log

Security for ace-jax 0.7.2

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.2.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 21, 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