Cairo Issue

[Habchy]

I keep getting ModuleNotFoundError: No module named 'cairo' when I try to load the cog.

I'm running: Redbot v3.3.9 Python 3.8.3

I have GTK+, pkg-config I'm also running Windows 10

Any help would be great.

[WildStriker]

Hi Habchy,

I spun up a new virtual machine to test this from scratch and did not appear to have any issues installing the 64 bit variant. I have not tested the 32 bit version but I expect it should work the same, and in most cases you probably want to use 64 bit version anyways.

Assuming everything is installed correctly, my only guess at this point is you may need restart Red in a new Command Prompt (or Power Shell) console. The reason for this is GTK will update the PATH environment variable and the console running Red will not be aware of this and can therefore not find the lib is needs for cairo.

Troubleshooting Steps:

If this is still not working here is a few things I can think of that could be a potentially cause this issue:

Incompatible Python, GTK installs, in most cases you probably want to install 64 bit for both.

• If you are running a 32 bit version of python and installed a 64 bit version of GTK+ or vice versa, they may not be able to "see" each other.
• If your not certain what version of python you have installed you can quickly see this when you run a python shell in your console:
• do this in your venv, incase you have multiple versions this is the one that matters.

System PATH issues:

• There could be something already in your System PATH variable that could be potentially confusing python where to find the cairo library. (I have ran into PATH issues plenty of times)
• An easy remedy is to move the GTK location in your PATH environment variable to the very top of the list, this should give it priority over any other potential paths that have cairo \ other incompatible libraries installed.
  • If this is the case, it could potentially mean fixing this issue could break something else for you? Hopefully not but something to keep in mind...

Installation Steps:

If it helps here is some steps I did from a clean install (Windows 10 64 bit):

1. Follow instructions provided: https://docs.discord.red/en/stable/install_windows.html
   • As per instructions install all prerequisites (I opted to do this manually)
   • At the time of writing this, these were the files I downloaded and installed:
     • https://www.python.org/ftp/python/3.8.3/python-3.8.3-amd64.exe
     • https://github.com/git-for-windows/git/releases/download/v2.27.0.windows.1/Git-2.27.0-64-bit.exe
     • https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=BuildTools&rel=16
   • Next set up venv and install Red
2. Install Cog:
   • [p]repo add wildcogs https://github.com/WildStriker/WildCogs master
   • [p]cog install wildcogs chessgame
3. Install GTK:
   • https://github.com/tschoonj/GTK-for-Windows-Runtime-Environment-Installer/releases/download/2020-05-19/gtk3-runtime-3.24.18-2020-05-19-ts-win64.exe

Important After installing GTK it will update your System PATH, because of this you will need to reload the Command Prompt console as it will not be aware of this change

• I can confirm at this point without reloading post-install of GTK I get the dreaded error message: ModuleNotFoundError: No module named 'cairo'
• In hindsight, I should update the install message to mention this as well as it may not be obvious to others.

At this point once everything is installed and you are running Red in a new Command Prompt window you should be able to load the cog with [p]load chessgame