Installation#

PyBispectra is available on PyPI, and conda-forge for version ≥ 1.2.2.

PyBispectra requires Python ≥ 3.10.

Package installation#

To install PyBispectra, activate the desired environment or project in which you want the package, then install it using pip:

pip install pybispectra

uv:

uv pip install pybispectra

conda:

conda install -c conda-forge pybispectra

or pixi:

pixi add pybispectra

Compatibility for newly released Python versions

If you encounter issues installing PyBispectra in environments with newly released Python versions, this may be due to a lack of compatible numba releases, one of PyBispectra’s core dependencies.

numba is not always immediately compatible with new Python versions, and there may be a delay of several weeks before a compatible version is released.

You can find the supported Python versions for numba in this table.

If a compatible numba release is available for your environment’s Python version and you are still encountering installation issues, please report this on the PyBispectra issue page.

Compatibility with Python ≥ 3.14 on macOS Intel systems

Due to wheel availability limitations for llvmlite on macOS Intel systems with Python ≥ 3.14, installation issues can arise when using pip and uv.

If you have a macOS Intel system and need to use Python ≥ 3.14, consider using conda or pixi for an easier installation.

Creating an environment or project for installation#

If you need to create an environment or project in which to install PyBispectra, you can do so using venv, uv, pixi, or conda.

With venv#

In a shell with Python available, navigate to your project location and create the environment:

python -m venv pybispectra_env

Activate the environment using the appropriate venv command for your operating system and shell, then install the package:

pip install pybispectra

With uv#

In a shell with uv available, navigate to your project location and create the environment:

uv venv pybispectra_env

Activate the environment using the appropriate uv command for your operating system and shell, then install the package:

uv pip install pybispectra

With pixi#

In a shell with pixi available, run the following commands:

pixi init
pixi shell-hook
pixi add pybispectra

With conda#

In a shell with conda available, run the following commands:

conda create -n pybispectra_env
conda activate pybispectra_env
conda install -c conda-forge pybispectra