Skip to content

FAIR-Chem/fairchem

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

6f8871c · Dec 20, 2024
Jul 13, 2024
Dec 10, 2024
Nov 26, 2024
Nov 25, 2024
Jun 19, 2020
Dec 4, 2024
Dec 19, 2024
Dec 19, 2024
Jan 21, 2022
May 11, 2024
Jul 12, 2024
May 7, 2024
Dec 20, 2024
Oct 4, 2023
May 7, 2024
Sep 17, 2024

Repository files navigation

fairchem by FAIR Chemistry

tests documentation PyPI - Version Static Badge

Open in GitHub Codespaces

fairchem is the FAIR Chemistry's centralized repository of all its data, models, demos, and application efforts for materials science and quantum chemistry.

Documentation

If you are looking for Open-Catalyst-Project/ocp, it can now be found at fairchem.core. Visit its corresponding documentation here.

Contents

The repository is organized into several directories to help you find what you are looking for:

Installation

Packages can be installed in your environment by the following:

pip install -e packages/fairchem-{fairchem-package-name}

fairchem.core requires you to first create your environment

Quick Start

Pretrained models can be used directly with ASE through our OCPCalculator interface:

from ase.build import fcc100, add_adsorbate, molecule
from ase.optimize import LBFGS
from fairchem.core import OCPCalculator

# Set up your system as an ASE atoms object
slab = fcc100('Cu', (3, 3, 3), vacuum=8)
adsorbate = molecule("CO")
add_adsorbate(slab, adsorbate, 2.0, 'bridge')

calc = OCPCalculator(
    model_name="EquiformerV2-31M-S2EF-OC20-All+MD",
    local_cache="pretrained_models",
    cpu=False,
)
slab.calc = calc

# Set up LBFGS dynamics object
dyn = LBFGS(slab)
dyn.run(0.05, 100)

If you are interested in training your own models or fine-tuning on your datasets, visit the documentation for more details and examples.

Why a single repository?

Since many of our repositories rely heavily on our other repositories, a single repository makes it really easy to test and ensure consistency across repositories. This should also help simplify the installation process for users who are interested in integrating many of the efforts into one place.

LICENSE

fairchem is available under a MIT License.