Fixing Python Installation Issues

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

Clarisse Python Error Message

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:

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!