django OSError: no library called "cairo" was found on windows

Question

When I run the Django server, I see this problem !!

OSError: no library called "cairo" was found

no library called "libcairo-2" was found

cannot load library 'libcairo.so': error 0x7e

cannot load library 'libcairo.2.dylib': error 0x

cannot load library 'libcairo-2.dll': error 0x7e

Please can you provide more details eg Version of Djano, version of Windows. — JohnC, Dec 25 '19 at 20:35
The output of `pip freeze` would be useful here. How are you running your Django project? with manage.py? — Danny Staple, Dec 25 '19 at 23:28

score 12 · Answer 1 · answered Jul 13 '20 at 01:36

Installing GTK+ didn't work for me. I solved this problem using UniConverter2.0. My environments is

Python 3.7
Windows 10 x64

Install uniconvertor-2.0rc4-win64_headless.msi,
Find the "dll" sub-directory under the UniConverter installation path.(In my case, C:\Program Files\UniConvertor-2.0rc4\dlls)
Add this "dll" path to the system path.
Close VSCode and reopen the project.
Try to run the server again. Enjoy!

score 10 · Accepted Answer · answered Dec 27 '19 at 05:20

10

WeasyPrint needs the Pango, cairo and GDK-PixBuf libraries. They are part of GTK+ (formerly known as GIMP Toolkit), and must be installed separately.

After installing GTK+ libraries, do :

python -m weasyprint http://weasyprint.org weasyprint.pdf

answered Dec 27 '19 at 05:20

Srijwal R

552
9
16

I am still getting this error even after installing the GTK – Umair Jul 27 '20 at 04:08
2

Do not forget to add the installed GTK+ lib to your system path, and restart your IDE so that the changes take effect. – Mathador Sep 17 '20 at 14:50
@Mathador agree. – Srijwal R Sep 18 '20 at 11:26
@Mathador how do i add them to the path? – yishairasowsky May 25 '21 at 13:49
1

Follow the instructions here: "http://gisaxs.com/index.php/View.gtk_installation" and replace "C:\GTK\bin" with the actual path where you installed the GTK package on your drive. – Mathador Jun 01 '21 at 14:09

score 4 · Answer 3 · answered Aug 04 '20 at 20:31

Starting from Python 3.8, dll's need to be added separately. Added GTK+, MSYS2, Visual Studio C Compiler and Uniconverter. But, nothing seemed to work. Finally, got it working after putting the script for calling add_dll_directory.

import os

def set_dll_search_path():
   # Python 3.8 no longer searches for DLLs in PATH, so we have to add
   # everything in PATH manually. Note that unlike PATH add_dll_directory
   # has no defined order, so if there are two cairo DLLs in PATH we
   # might get a random one.
   if os.name != "nt" or not hasattr(os, "add_dll_directory"):
       return
   for p in os.environ.get("PATH", "").split(os.pathsep):
       try:
           os.add_dll_directory(p)
       except OSError:
           pass


set_dll_search_path()

Source: PyCairo Windows Python3.8 Import Issue

OMG this is what fixed for me after nothing else. Thanks! – Nick Garyu Sep 05 '21 at 00:48 — Nick Garyu, Sep 05 '21 at 00:48

score 2 · Answer 4 · answered Jul 12 '21 at 10:21

2

See the solution here:

https://www.programmersought.com/article/47674569357/

You will need to add a path if not added after installations:

C:\Program Files\GTK3-Runtime Win64\bin

I have been solving it many times this way.

answered Jul 12 '21 at 10:21

Sushil Champ

39
2

score 2 · Answer 5 · answered Dec 30 '21 at 15:36

If you are using a lightweight Linux Docker Image, it may not include GTK as said above, then, you can include it by adding in your Dockerfile

RUN apt-get update -y
RUN apt-get install python3-cffi python3-brotli libpango-1.0-0 libharfbuzz0b libpangoft2-1.0-0 libgtk-3-dev gcc -y

Where all those packages are recommended to be installed by weasyprint and GCC has the GTK.

score 1 · Answer 6 · edited Dec 09 '21 at 16:23

Ok I figure this out. you can have a 64 bit version of python that doesn't work. What I have found to work and this could change is the installing the 64 bit version of python from python's website, not from the Microsoft store!

remove any version of python you have installed
download https://www.python.org/ftp/python/3.8.10/python-3.8.10-amd64.exe
install
download and install https://github.com/tschoonj/GTK-for-Windows-Runtime-Environment-Installer/releases
1. exact link is https://github.com/tschoonj/GTK-for-Windows-Runtime-Environment-Installer/releases/download/2021-04-29/gtk3-runtime-3.24.29-2021-04-29-ts-win64.exe
2. note that link is from https://doc.courtbouillon.org/weasyprint/stable/first_steps.html#windows
add bin folder from that (sorry it was somebody else's machine, I use Ubuntu) in your environment path.
run through the first steps on weasyprint and you should be good to go!

Yep, that did the trick! Seems to be an issue with Python installed from the Microsoft Store. I took Python 3.10.1 and it worked for me. Maybe just don’t put a direct link to a specific Python installer, just point to the official website like you did for the GTK installer. Also note that this way of installing Python does not provide the `python3` command-line alias. [Just use `python` instead](https://stackoverflow.com/a/40931434/525036). — Didier L, Dec 09 '21 at 16:30

score 1 · Answer 7 · answered Jan 03 '23 at 19:47

Try this: https://cairocffi.readthedocs.io/en/stable/overview.html#installing-cairo-on-windows

And maybe this will work to: https://www.lfd.uci.edu/~gohlke/pythonlibs/#pycairo

Best option is instal cairocffi trough pipwin

pip install pipwin

pipwin install cairocffi

score 0 · Answer 8 · answered Jul 01 '21 at 05:10

Might be a bit late, but I just encoutered the same issue and: Start here: https://weasyprint.readthedocs.io/en/stable/install.html#windows. Where you will find the links for the GTK Pack that contains the required DLLs.

In my case, I have a 64bit Python, so i use: "Download and run the latest gtk3-runtime-x.x.x-x-x-x-ts-win64.exe"

I did not change the installation directory

Once the installation is completed. I added the path to my variable paths.

I restarted the terminal, made sure I could locate the DLLs with : WHERE libcairo-2.dll. This retured C:\Program Files\GTK3-Runtime Win64\bin\libcairo-2.dll

Then I run python -m weasyprint http://weasyprint.org weasyprint.pdf and got a few WARNINGs but they are just warnings :)

score 0 · Answer 9 · answered Aug 18 '21 at 13:53

0

I have faced same error as well

I haved installed gtk as followed as gtk install in windows

Nothing worked

After that :

python -m pip install pycairo

solved the problem for me

answered Aug 18 '21 at 13:53

Ramesh Ponnusamy

1,553
11
22

django OSError: no library called "cairo" was found on windows

9 Answers9

Linked