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++23.
- gcc 12 (or higher) works
- clang 18 (or higher) works
- XCode 15 (or higher) works
On Ubuntu 24.04 (or higher), or on Debian testing, you can use apt-get:
sudo apt-get install g++ libcairo2-dev meson libboost-all-devOn Mac (or Linux, actually) you can use homebrew:
brew install cairo meson boostOn 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
export BOOST_ROOT=$CONDA_PREFIX
After installing prerequisites above, check that the meson version is at least 1.1.
meson --version
If your version of meson is less than 1.1, you need to install the most recent version of meson into a python virtual environment:
python3 -m venv meson_venv
source meson_venv/bin/activate
pip install meson ninja
This will build the latest version of BAli-Phy. It may have some changes that have not yet been released. Check the [NEWS.md] file for the details.
git clone https://github.com/bredelings/BAli-Phy.git
cd BAli-Phy
meson setup build --prefix=$HOME/Applications/bali-phy
ninja -C build install
ninja -C build test
In order to run the installed software, you should add bali-phy to your $PATH.
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. |
The Manual describes how to install bali-phy in greater detail.