pyteuf requires the following packages:

Make sure your Python environment is properly configured. It is recommended to install pyteuf in a virtual environment.

Release version

First, make sure you have the latest version of pip (the Python package manager) installed. If you do not, refer to the Pip documentation and install pip first.

Install the current release with pip:

pip install pyteuf

To upgrade to a newer release use the --upgrade flag:

pip install --upgrade pyteuf

If you do not have permission to install software systemwide, you can install into your user directory using the --user flag:

pip install --user pyteuf

Alternatively, you can manually download pyteuf from its GitLab project or PyPI. To install one of these versions, unpack it and run the following from the top-level source directory using the Terminal:

pip install .

Development version

If you have Git installed on your system, it is also possible to install the development version of pyteuf.

Before installing the development version, you may need to uninstall the standard version of pyteuf using pip:

pip uninstall pyteuf

Clone the Git repository:

git clone
cd pyteuf

You may also need to install required packages:

pip install -r requirements/defaults.txt

Then execute pip with flag -e to follow the development branch:

pip install -e .

To update pyteuf at any time, in the same directory do:

git pull

To run unitary tests, first install required packages:

pip install -r requirements/dev.txt

and execute pytest: