This repo is integrated with workflow tools like QuAcc to make complex molecular simulation workflows easy. You can use any MLP recipe (relaxations, single-points, elastic calculations, etc.) and simply specify the fairchem model type.
Below is an example that uses the default elastic_tensor_flow flow:
from __future__ import annotations
from ase.build import bulk
from quacc.recipes.mlip.elastic import elastic_tensor_flow
# Make an Atoms object of a bulk Cu structure
atoms = bulk("Cu")
# Run an elastic property calculation with our favorite MLP potential
result = elastic_tensor_flow(
atoms,
job_params={
"all": dict(
library="fairchem",
name_or_path="uma-s-1p2",
task_name="omat",
),
},
)INFO:matplotlib.font_manager:generated new fontManager
INFO:httpx:HTTP Request: HEAD https://huggingface.co/facebook/UMA/resolve/main/checkpoints/uma-s-1p2.pt "HTTP/1.1 302 Found"
INFO:httpx:HTTP Request: HEAD https://huggingface.co/facebook/UMA/resolve/main/references/iso_atom_elem_refs.yaml "HTTP/1.1 200 OK"
INFO:httpx:HTTP Request: HEAD https://huggingface.co/facebook/UMA/resolve/main/references/form_elem_refs.yaml "HTTP/1.1 200 OK"
WARNING:root:device was not explicitly set, using device='cuda'.
INFO:root:Adding 5 untrained task(s): ['omol_stress', 'odac_stress', 'oc25_stress', 'oc20_stress', 'oc22_stress']
WARNING:root:The 'seed' argument is deprecated and will be removed in future versions. Please set the seed in the MLIPPredictUnit configuration instead.
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-47-08-612542-59941
WARNING:root:Model is being compiled this might take a while for the first time
W0807 05:47:09.519000 7953 site-packages/torch/_logging/_internal.py:1345] [0/0] Profiler record function <class 'torch.autograd.profiler.record_function'> will be ignored
W0807 05:47:12.545000 7953 site-packages/torch/_inductor/utils.py:1953] [3/0_1] Not enough SMs to use max_autotune_gemm mode
/home/runner/work/_tool/Python/3.12.13/x64/lib/python3.12/site-packages/torch/_inductor/lowering.py:2352: FutureWarning: `torch._prims_common.check` is deprecated and will be removed in the future. Please use `torch._check*` functions instead.
check(
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-47-08-612542-59941 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-47-08-612542-59941
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-47-08-612542-59941
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-45-895991-53545
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-45-895991-53545 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-45-895991-53545
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-45-895991-53545
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-46-084765-40240
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-46-084765-40240 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-46-084765-40240
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-46-084765-40240
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-46-268675-31762
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-46-268675-31762 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-46-268675-31762
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-46-268675-31762
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-46-458922-60545
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-46-458922-60545 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-46-458922-60545
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-46-458922-60545
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-46-640610-85751
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-46-640610-85751 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-46-640610-85751
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-46-640610-85751
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-47-863339-47153
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-47-863339-47153 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-47-863339-47153
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-47-863339-47153
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-48-040452-82490
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-48-040452-82490 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-48-040452-82490
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-48-040452-82490
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-48-217343-46278
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-48-217343-46278 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-48-217343-46278
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-48-217343-46278
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-48-395569-60271
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-48-395569-60271 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-48-395569-60271
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-48-395569-60271
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-48-571935-85553
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-48-571935-85553 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-48-571935-85553
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-48-571935-85553
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-48-751399-11222
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-48-751399-11222 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-48-751399-11222
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-48-751399-11222
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-48-932845-42646
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-48-932845-42646 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-48-932845-42646
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-48-932845-42646
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-49-110975-96714
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-49-110975-96714 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-49-110975-96714
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-49-110975-96714
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-49-278940-12403
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-49-278940-12403 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-49-278940-12403
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-49-278940-12403
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-49-453146-67592
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-49-453146-67592 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-49-453146-67592
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-49-453146-67592
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-49-634175-30322
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-49-634175-30322 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-49-634175-30322
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-49-634175-30322
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-49-805601-29639
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-49-805601-29639 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-49-805601-29639
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-49-805601-29639
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-49-977676-51796
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-49-977676-51796 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-49-977676-51796
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-49-977676-51796
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-50-153682-31955
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-50-153682-31955 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-50-153682-31955
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-50-153682-31955
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-50-330009-43752
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-50-330009-43752 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-50-330009-43752
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-50-330009-43752
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-50-504247-95806
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-50-504247-95806 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-50-504247-95806
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-50-504247-95806
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-50-673466-91366
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-50-673466-91366 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-50-673466-91366
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-50-673466-91366
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-50-847135-86518
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-50-847135-86518 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-50-847135-86518
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-50-847135-86518
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-51-022705-17798
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-07-05-48-51-022705-17798 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-51-022705-17798
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-07-05-48-51-022705-17798