🛠️ Troubleshooting

This section explains common troubleshooting steps.

Windows: OSError: cannot load library 'pangoft2...'

There is a known issue with the pango dependency (that is used by the WeasyPrint dependency we currently use for creating a PDF report):

This can cause an error like this when launching CliMB UI on Windows systems:

OSError: cannot load library 'pangoft2-1.0-0': error 0x7e. Additionally, ctypes.util.find_library() did not manage to locate a library called 'pangoft2-1.0-0'

If you encounter this issue CliMB will still work, but you will see a message similar to this:

Error importing weasyprint:
OSError: cannot load library 'pangoft2-1.0-0': ...

You will not be able to generate a PDF report if you are encountering this.

To fix this error, you can follow the following steps:

  1. Locate your climb environment’s directory. You can find it by e.g. running conda env list. Then, locate the binary libraries directory - e.g. if your environment is at C:\Users\<username>\miniconda3\envs\climb, the binary libraries directory will be C:\Users\<username>\miniconda3\envs\climb\Libraries\bin.

  2. Download the missing pangoft2-1.0 DLL file from this DLLme link.

    • Please use the dropdown menu to choose the appropriate architecture (most machines are x86-64 (64 bit)), and then download the highest version file from the list.

    • It is best practice to do a security scan on this file, e.g. with Windows Defender.

  3. Place this downloaded pangoft2-1.0-0.dll file into your CliMB environment’s binary libraries directory (typically C:\Users\<username>\miniconda3\envs\climb\Libraries\bin).

conda not found (OSError: file not found)

If whenever CliMB tries to execute a tool or generate code, you see an error similar to OSError: file not found, this most likely indicates that it cannot find the location of your conda executable. if you know that conda is installed (see 📦 Installation) on your system and this issue is happening, follow the below steps to resolve this.

  1. Determine the path to your conda installation. You can use a command like: which conda (Linux, OSX) or where conda (Windows, in Anaconda PowerShell Prompt). Make note of the full conda path shown.

  2. Set the full conda path in your .env/keys.env file. Add a line like so:

    CONDA_PATH="/path/to/your/conda"

    Replace /path/to/your/conda with the path you found in step 1.

  3. Restart the tool and try running the generated code again.