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): ['oc22_stress', 'oc25_stress', 'odac_stress', 'omol_stress', 'oc20_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-19-23-53-17-825446-59941
WARNING:root:Model is being compiled this might take a while for the first time
W0819 23:53:19.692000 8041 site-packages/torch/_logging/_internal.py:1345] [0/0] Profiler record function <class 'torch.autograd.profiler.record_function'> will be ignored
W0819 23:53:23.046000 8041 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.14/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-19-23-53-17-825446-59941 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-53-17-825446-59941
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-53-17-825446-59941
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-54-58-773474-53545
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-54-58-773474-53545 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-54-58-773474-53545
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-54-58-773474-53545
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-54-58-963139-40240
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-54-58-963139-40240 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-54-58-963139-40240
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-54-58-963139-40240
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-54-59-150682-31762
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-54-59-150682-31762 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-54-59-150682-31762
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-54-59-150682-31762
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-54-59-340810-60545
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-54-59-340810-60545 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-54-59-340810-60545
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-54-59-340810-60545
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-54-59-525324-85751
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-54-59-525324-85751 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-54-59-525324-85751
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-54-59-525324-85751
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-54-59-710983-47153
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-54-59-710983-47153 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-54-59-710983-47153
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-54-59-710983-47153
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-54-59-903299-82490
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-54-59-903299-82490 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-54-59-903299-82490
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-54-59-903299-82490
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-00-089436-46278
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-00-089436-46278 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-00-089436-46278
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-00-089436-46278
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-00-275244-60271
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-00-275244-60271 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-00-275244-60271
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-00-275244-60271
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-01-556405-85553
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-01-556405-85553 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-01-556405-85553
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-01-556405-85553
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-01-742628-11222
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-01-742628-11222 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-01-742628-11222
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-01-742628-11222
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-01-928997-42646
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-01-928997-42646 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-01-928997-42646
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-01-928997-42646
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-02-111676-96714
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-02-111676-96714 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-02-111676-96714
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-02-111676-96714
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-02-283889-12403
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-02-283889-12403 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-02-283889-12403
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-02-283889-12403
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-02-460744-67592
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-02-460744-67592 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-02-460744-67592
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-02-460744-67592
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-02-645011-30322
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-02-645011-30322 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-02-645011-30322
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-02-645011-30322
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-02-821198-29639
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-02-821198-29639 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-02-821198-29639
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-02-821198-29639
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-03-018819-51796
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-03-018819-51796 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-03-018819-51796
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-03-018819-51796
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-03-196985-31955
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-03-196985-31955 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-03-196985-31955
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-03-196985-31955
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-03-379336-43752
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-03-379336-43752 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-03-379336-43752
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-03-379336-43752
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-03-558344-95806
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-03-558344-95806 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-03-558344-95806
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-03-558344-95806
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-03-732641-91366
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-03-732641-91366 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-03-732641-91366
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-03-732641-91366
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-03-911699-86518
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-03-911699-86518 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-03-911699-86518
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-03-911699-86518
INFO:quacc.runners.prep:Calculation will run at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-04-093624-17798
INFO:quacc.runners.prep:Moving /home/runner/work/fairchem/fairchem/docs/core/common_tasks/tmp-quacc-2026-08-19-23-55-04-093624-17798 contents to /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-04-093624-17798
INFO:quacc.runners.prep:Calculation results stored at /home/runner/work/fairchem/fairchem/docs/core/common_tasks/quacc-2026-08-19-23-55-04-093624-17798