Troubleshoot BornAgain

These checks apply to packages installed from PyPI or Homebrew.

No compatible distribution is available

When installing BornAgain, pip may report:

ERROR: No matching distribution found for bornagain

With uv, read the explanation following this line for details about the Python version or wheel compatibility:

× No solution found when resolving dependencies:

Your Python version may be older or newer than those supported. BornAgain 25.0.0 wheels are available for Python 3.10–3.14 on Linux and Windows. Check with python --version.

Linux: the wheels require glibc 2.35 or newer. If your distribution uses an older glibc, use a newer distribution or build from source.

macOS: install through Homebrew.

Python cannot import BornAgain

ModuleNotFoundError: No module named 'bornagain'

Run the script with the Python interpreter from the environment where BornAgain is installed. Activate that environment or select its interpreter in your editor. Check the interpreter path:

python -c "import sys; print(sys.executable)"

If BornAgain is not installed in that environment, follow the installation instructions.

An example cannot import an optional package

ModuleNotFoundError: No module named 'lmfit'

Some examples need optional packages such as lmfit, fabio, or periodictable. Install the missing package in the environment used to run the example:

python -m pip install lmfit

With uv, use uv pip install --python path/to/python lmfit, replacing path/to/python with the interpreter used to run the example.

Windows cannot display the 3D sample

When opening a 3D sample view, you may see messages such as:

Failed to initialize OpenGL functions!
osmesa.dll not found. It appears that OSMesa is not installed in your system.

For software OpenGL support, install Mesa for Windows and run its system-wide deployment tool.