The simplest way to install the most recent release of Jonga from PyPI is

pip install jonga

Jonga can also be installed from source, either from the development version from GitHub, or from a release source package downloaded from PyPI.

To install the development version from GitHub do

git clone git://

followed by

cd jonga
python build
python install

The install command will usually have to be performed with root permissions, e.g. on Ubuntu Linux

sudo -H python install

The procedure for installing from a source package downloaded from PyPI is similar.

Note that under Ubuntu Linux, in the commands listed above, python and pip should be replaced with python3 and pip3 respectively.

Jonga can also be installed as a conda package from the conda-forge channel

conda install -c conda-forge jonga


The primary requirement is Python 3.3 or greater (this packages is not compatible with Python 2), imposed by the use of the __qualname__ function attribute and inspect.getclosurevars. The __qualname__ attribute could be replaced in earlier versions of Python by qualname, but there is no obvious replacement for inspect.getclosurevars, which was introduced in Python 3.3.

The other major requirement is pygraphviz. Under Ubuntu Linux 18.04, this requirement can be installed by the command

sudo apt-get install python3-pygraphviz


Package matplotlib is required to run the included Jupyter Notebook examples.

Packages pytest and pytest-runner are required to run the tests (python test or python3 test, depending on the operating system).

Packages sphinx, sphinx-bootstrap-theme, and numpydoc are required to build the documentation (python build_sphinx or python3 build_sphinx, depending on the operating system).