Fixing Python Installation Issues

After a fresh install of Clarisse, Clarisse may prompt you with an error message regarding a Python installation issue.

Please note that sometimes this error message is not displayed however, you only can see File > Quit in Clarisse’s application main menu bar. These problems typically occur when:

• Python is not properly installed on your operating system
• The location of the python path environment variables are not properly set
• The version of Python installed on the system is not supported. Clarisse 5 only supports Python 3.7.x because of its compliance to VFX Reference Platform 2020. Older or newer versions such as 3.8.x or 3.9.x are not supported.

Before finding the right solution, we first have to identify what’s the issue with your installation.

A. Checking Python Installation

Open a Terminal, type python and press the Enter key. If you get a message like:

-bash: python: command not found

Then Python is not installed. Go to Step B

However, if you see a command-line window displaying a message such as:

Python 3.7.6 (default, Mar 13 2020, 14:46:27) [GCC 6.3.1 20170216 (Red Hat 6.3.1-3)] on linux Type "help", "copyright", "credits" or "license" for more information. >>>

Then Python is properly installed you can directly skip to Step C. 

B. Making a clean installation of Python 3.7

Python installation process depends on your linux distribution. Unfortunately most distributions do not package a prebuilt version of Python 3.7. You will need to compile it and install it from the source code.

Once installed, launch Clarisse and if the problem persists go to Step C

C. Editing clarisse.env file

Our goal here is to find where python is installed on the system.

1. Open a Terminal type python and press the Enter key.

2. In the python shell type import sys;print(sys.path) and press Enter key. You should get something like this:

['', '/usr/local/lib/python37.zip', '/usr/local/lib/python3.7', '/usr/local/lib/python3.7/lib-dynload', '/usr/local/lib/python3.7/site-packages']

In this example we can see Python is installed in /usr/local/lib/python3.7


3. Now go to this location ~/.isotropix/clarisse

Inside the folder, you should see a folder for each version of Clarisse you have installed (for example 3.6, 4.0, 5.0...). Go to the one you are troubleshooting. You will find a few files there. Open clarisse.env file using any text editor programs or create it if it doesn’t exist. 

In our example, Python was installed in /usr/local/lib/python3.7. In clarisse.env file make sure you have:

IX_PYTHON3HOME=/usr/local/lib/python3.7 IX_PYTHON3PATH=/usr/local/lib/python3.7/lib-dynload IX_SHELF_CONFIG_FILE=$IX_PYTHON_API_PATH/shelves/shelf.cfg IX_MENU_CONFIG_FILE=$IX_PYTHON_API_PATH/menus/init_menus.py

4. Run Clarisse and that's it!