Install pycalphad

Operating System

Package manager



Anaconda is a distribution platform for scientific Python packages created by Anaconda, Inc. It comes bundled with the conda package manager to install Python and non-Python packages. If you don’t have Anaconda already, you can download the Miniconda distribution.

To install pycalphad from conda-forge using conda:

conda install -c conda-forge pycalphad

Development version


The source code for the latest development version of pycalphad is available on GitHub. You will need a working version of git to download the source code. Installing development versions of pycalphad also requires a working C++ compiler.

To install an editable version the latest development branch of pycalphad, run:

git clone
cd pycalphad
pip install -U pip setuptools
pip install -U -r requirements-dev.txt
pip install -U --no-build-isolation --editable .

Then run the automated tests to ensure everything installed correctly:

pytest pycalphad


Changes to Python files (.py extension) in an editable install will be reflected as soon a file is saved. Changes to Cython files (.pyx and .pxd extensions) must be recompiled before they take effect. The Cython files can be recompiled by running (from the root directory 1 of the project):

python build_ext --inplace

By default, the development version installed will track the latest changes in the develop branch of pycalphad on GitHub.

To update the code in the current branch to the latest changes on GitHub, the changes are pulled from GitHub by running git pull.

To switch to a different branch, e.g. master (which tracks the latest released version) or another feature branch, run git checkout <branch>, where <branch> is the name of the branch to checkout, such as master (without the brackets < and >).


The “root directory” is the the top level project directory containing the pyproject.toml file, the pycalphad/ package directory, etc.