Installation

The following steps work installing the dependencies in Linux via apt-get. While using package managers such as Anaconda, Miniforge, or Mamba might work, these are not tested. The supported Python versions are 3.12 to 3.14.

Python package

To install the pymm executable from the development version:

pip install git+https://github.com/cssr-tools/pymm.git

If you are interested in a specific version (e.g., v2026.04) or in modifying the source code, then you can clone the repository and install the Python requirements in a virtual environment with the following commands:

# Clone the repo
git clone https://github.com/cssr-tools/pymm.git
# Get inside the folder
cd pymm
# For a specific version (e.g., v2026.04), or skip this step (i.e., edge version)
git checkout v2026.04
# Create virtual environment (to specific Python, python3.12 -m venv vpymm)
python3 -m venv vpymm
# Activate virtual environment
source vpymm/bin/activate
# Upgrade pip, setuptools, and wheel
pip install --upgrade pip setuptools wheel
# Install the pymm package
pip install -e .
# For contributions/testing/linting, install the dev-requirements
pip install -r dev-requirements.txt

Tip

Typing git tag -l writes all available specific versions.

OpenFOAM

See the OpenFOAM page, where from OpenFOAM-12 the simulator is available via apt get, and OpenFOAM-13 is the latest release. To test if OpenFoam is installed and working, you could type in the terminal:

source /opt/openfoam13/etc/bashrc
foamRun -help

Gmsh

See the Gmsh page.

Tip

See the CI.yml script for installation of pymm, gmsh, and OpenFOAM-13 in Ubuntu using Python 3.14.