Brea requires Python 3.7 or later. If you do not already have a Python environment configured on your computer, please see the instructions for installing the full scientific Python stack.


If you are using the Windows platform and want to install optional packages (e.g., scipy), then it may be useful to install a Python distribution such as: Anaconda, Enthought Canopy, Python(x,y), WinPython, or Pyzo. If you already use one of these Python distributions, please refer to their online documentation.

Below it is assumed, that you have the default Python environment configured on your computer and you intend to install Brea inside of it. If you want to create and work with Python virtual environments, please follow instructions on venv and virtual environments.

Install the latest distributed package

You can install the latest distributed package of Brea by using pip:

$ pip install brea

Install the development branch

The installation requires that you have Git installed on your system. Under this prerequisite the first step is to clone the GitHub repository of Brea:

$ git clone

Thereupon the development branch can locally be installed by using pip:

$ cd brea
$ pip install -e .

The pip install command allows you to follow the development branch as it changes by creating links in the right places and installing the command line scripts to the appropriate locations.

Update the development branch

Once you have cloned the GitHub repository onto a local directory, you can update it anytime by running a git pull in this directory:

$ git pull

Testing the development branch

Brea uses the Python builtin module :module:`unittest` for testing. Since the tests are not included in the distributed package at you are required to install the development branch, as described above. Thereupon you have to switch to the repository directory and run:

$ python3 tests