Skip to content

Installing Clarisse#

Clarisse is a cross platform application and this section reviews all the different installation procedures related to each platform. Feel free to skip to your favored platform but first make sure your system meets Clarisse system requirements below.

Minimum System Requirements#

Clarisse has a modern multithreaded architecture and uses all the available system cores. The more cores your CPU has the faster the evaluation gets. At the time of this writing, since Clarisse only uses GPUs on some rare occasion, it doesn't require a high-end graphics card.

For the latest minimum system requirements, please refer to System Requirements

Installation Package#

We don't provide an installer for Clarisse on all platforms. It comes either as an installer on Windows, a DMG iso on macOS and as an archive file on Linux.


Launch the installer and follow the instructions.


Extract directly the archive content to any destination folder.


To install Clarisse, open the disk image and drag the Clarisse folder into the Applications folder.

Python in Clarisse#

Unlike many other applications, Clarisse doesn't provide its own version of Python. Instead, it uses the one installed in the system.

This way, there are no limitation and you can use any available Python extensions. Python is generally installed by default on Linux and macOS but not on Windows.

For convenience, Clarisse Windows installer provides the appropriate 64-bit installation of Python which gets installed by default.

Python 2.7.x and 3.7.x#

Since January 1st, 2020, Python 2.7.x development and support has been discontinued. For more information, please refer here. However, Clarisse 5 still provides Python 2.7.x compatibility to help users in their effort migrating to Python 3.7.x.


Clarisse 5 is the last major version providing Python 2.7.x compatibility. In the future, Clarisse will only provide the version of Python in compliance with VFX Reference Platform.

By default, Clarisse will automatically run using Python 3.7.x engine. However it is possible to specify the version of Python you wish to use from the command line by specifying the argument -python_version.

For more information please refer to Specifying Python Version.


In the past, Clarisse could use the system environment variables PYTHONHOME and PYTHONPATH to define the location of Python. Unfortunately, since Clarisse 5 can run using either 2.7.x or 3.7.x it must ignore these system variables to run properly.

Specifying Python Location#

By default, Clarisse should automatically locate where Python is installed on supported platforms.

However, if the installation path has been customized or if Clarisse is running on a not officially supported platform/distribution, you may have to manually specify Python Location.

In that case, you'll need to manually set Python environment variables to where Python is installed or define the variables in clarisse.env file. clarisse.env file can be found in the directory where Clarisse configuration is located.

For more information on Clarisse configuration file please refer to Configuration and Environment section.

Follow the exact same procedure if you wish to specify a custom Python build. If you have any issues regarding the installation of Python please refer to