Installation

Granny was built using Python3 and can be run on any modern operating system including variants of Linux, OS X, and potentially Windows. Currently to install Granny, you must use the command-line interface. Follow the installation instructions that match the operating system you are using.

Requirements

Granny requires Python verison 3.9 or greater. It also requires several python packages such as ultralytics, numpy, and opencv-python but these packages will be installed automatically when Granny is installed.

Please see the Python instructions for downloading and installing Python. Alternatively, you can install Anaconda which is a data analytics platform which includes Python.

Opening the terminal

Ubuntu 22.04 Terminal

The command-line interface for Granny can be opened by clicking on Ubuntu icon on the task bar:

../_images/install_ubuntu_icon.png

Search for “terminal” in the search box that appears. Click the icon with the title “terminal” and the terminal should appear:

../_images/install_ubuntu_terminal.png

Within the terminal you can type the commands to install Granny.

Mac OS X Terminal

Note

Follow the same instructions as Linux: Ubuntu 22.04.

Install the Most Recent Release

Windows Terminal

Warning

We do not currently support Granny for Windows.

Ubuntu 22.04 Installation

Python3 comes pre-installed on Ubuntu. You can install Granny along with all its dependencies using the pip3 command in the terminal in the following way:

pip3 install granny

You will see output printed to the terminal as the installation progresses. If successful, you will see something similar to the following:

Installing collected packages: granny
Successfully installed granny-1.0a1

Mac OS X Installation

Python3 comes pre-installed on OS X. You can install Granny along with all its dependencies using the pip3 command in the terminal in the following way:

pip3 install granny

You will see output printed to the terminal as the installation progresses. If successful, you will see something similar to the following:

Installing collected packages: granny
Successfully installed granny-1.0a1

Windows Installation

Warning

There is currently a dependency missing for Granny to run in Windows and we encourage users of Granny to use a Linux or OS X computer to use Granny. You are welcome to try Granny on Windows but we will not currently offer support for this operating system.

Install the Development Version

For most users, the development version of Granny should not be used. This is where leading-edge code is housed before it gets added to a release version. However, if you would like to explore using the development version, perhaps to test new features, you can install following these instructions.

Warning

The development version of Granny may not be stable. If you have any issues using this version please post an issue on the Granny GitHub issue queue.

To retrieve granny you must have git installed <https://git-scm.com/book/en/v2/Getting-Started-Installing-Git>. In the terminal run the following commands:

git clone -b dev https://github.com/SystemsGenetics/granny.git

This command will pull the most recent version of the Granny code from the dev (development) branch.

You can then install the development version of granny by specifying the path to where you “cloned” Granny. For example on Ubuntu 22.04 the command would like the following.

pip3 install ./granny