Before you start


Terran will install the default Pytorch release in during setup. If you need a custom option, such as supporting a different CUDA version, or the non-GPU version, you’ll need to install it yourself beforehand.


Terran makes use of FFmpeg in order to provide I/O-related functions for videos. As such, make sure you have it installed as a system dependency if you want to run predictions on videos.


Visualization functions can leverage Cairo to draw the visualization graphics, making them better-looking. When Cairo is not present, it will use PIL as fallback.

(TODO: Show difference between the two.)


Terran can use feh as backend to display images (through the terran.vis.display_image function). If you don’t have it installed, it will use matplotlib as fallback, but we recommend the former.

Installing from PyPI

Terran may be installing by using pip with the following command:

pip install terran

Installing from source

Start by cloning the Terran repository:

git clone

Then install the library by running:

cd terran
pip install -e .