Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit



Failed to load latest commit information.

Build and test


If you just want to install bali-phy, please visit the release page. If you want to compile BAli-phy from source, the quick start instructions are below.


You will need a C++ compiler that understands C++20.

  • gcc 10 (or higher) works
  • clang 13 (or higher) works
  • XCode 14 (or higher) works

Install Prerequisites

On Ubuntu, you can use apt-get:

sudo apt-get install g++ libcairo2-dev meson libboost-all-dev

On Mac (or Linux, actually) you can use homebrew:

brew install cairo meson boost pkg-config

On miniconda, you can use:

conda create -n devel -c conda-forge --strict-channel-priority
conda activate devel
conda install meson gxx boost-cpp cmake pkg-config cairo

The meson version needs to be at least 1.1. If your distribution provides a version of meson that is less than 1.1, then you may need to install meson through the python package manager "pip" or "pip3":

pip3 -V
pip3 install --user meson ninja

Build BAli-Phy

This will build the latest unreleased beta version of BAli-Phy, which fixes some memory issues in 3.6. There are some changes to the model language. Check the NEWS file for the details.

git clone
cd BAli-Phy
meson setup build --prefix=$HOME/Applications/bali-phy
ninja -C build install
ninja -C build test

Adding bali-phy to your $PATH

In order to run the installed software, you should add bali-phy to your $PATH.

Installed locations

If you installed in $HOME/Applications/bali-phy/ as recommended above, then files will be in:

Location Files
~/Applications/bali-phy/bin Binary executables.
~/Applications/bali-phy/share/bali-phy/examples/sequences Example files.
~/Applications/bali-phy/share/doc/bali-phy/ Documentation.

Further Documentation

The Manual describes how to install bali-phy in greater detail.