cond-mat.mtrl-sciNov 15, 2026

IANN: A Unified Framework for Equivariant InterAtomic Neural Networks with User-Friendly Implementation

Authors: Changzhi Ai, Xueping Qin, Dimosthenis Sokaras, Frank Abild-Pedersen, Johannes Voss

Organizations: Department of Chemical Engineering, Stanford University, Stanford, California 94305, United States · SUNCAT Center for Interface Science and Catalysis, SLAC National Accelerator Laboratory, Menlo Park, California 94025, United States · Stanford Synchrotron Radiation Lightsource, SLAC National Accelerator Laboratory, Menlo Park, California 94025, United States · Center for Nanoscale Materials, Argonne National Laboratory, Lemont, Illinois, United States

Abstract

Machine-learning interatomic potentials (MLIPs) now approach density functional theory (DFT) accuracy at a fraction of its cost, but the practical benefit is limited by software fragmentation: each state-of-the-art architecture is released as a separate codebase, with its own data format, configuration system, training loop and molecular-dynamics interface. Comparing two architectures on the same dataset, or moving a trained model into a production simulation, therefore requires substantial re-engineering. We introduce IANN (InterAtomic Neural Network), an open-source PyTorch framework that reimplements equivariant graph neural networks - PaiNN, NequIP, MACE, Allegro, EquiformerV2, EquiformerV3 and UMA - behind a unified data object, a unified trainer and a single deployment route, so that the architecture is a one-word change in a configuration dictionary. Forces, stresses and virials are obtained for every architecture from one analytic differentiation of the energy with respect to the edge vectors of the atomic graph, exact under periodic boundary conditions. Distributed training is configured automatically from the SLURM, PBS or MPI environment, so the same script runs unchanged from a workstation to a multi-node GPU allocation. Self-describing checkpoints serve directly as ASE calculators, as ensembles reporting uncertainties, or as TorchScript models run inside LAMMPS through bundled C++ pair styles with single- and multi-GPU inference. Trained on a common dataset of millions of structures, the architectures can be compared under identical conditions. We further release PaiNN foundation models trained on 41.9 million curated DFT structures from MPtrj, Alexandria, OMat24, MatPES, OC20, OC22, OC25, MPr2SCAN and MatPESr2SCAN, spanning the PBE, RPBE and r2SCAN functionals. Additionally, IANN provides an agent interface to facilitate integration with autonomous agents.

Figures & tables

Appendix figures & tables60 assets

Supplementary material from the paper’s appendix.

Appendix

Explore similar work

CardsList
  1. Universal and efficient graph neural networks with dynamic attention for machine learning interatomic potentials

    Mar 24, 2026Shuyu Bi, Zhede Zhao, Qiangchao Sun +3Machine Learning Interatomic PotentialsGraph Neural Networks

  2. BranchIP: Learning Adaptive Equivariant Computation for Interatomic Potentials

    Oct 1, 2026Laura Zichi, Gil Harari, Chuin Wei Tan +6Machine Learning Interatomic PotentialsEquivariant Neural Networks

  3. TriForces: Augmenting Atomistic GNNs for Transferable Representations

    May 20, 2026Ali Ramlaoui, Alexandre Duval, Hannah Bull +4Disentangled Representation LearningMachine Learning Interatomic Potentials