Fixed: No module named ‘frontend’ when importing fitz (PyMuPDF)

Error displayed:

import fitz # PyMuPDF
Traceback (most recent call last):
File “”, line 1, in
File “C:\Users\kkk\AppData\Roaming\Python\Python310\site-packages\fitz__init__.py”, line 1, in
from frontend import *
ModuleNotFoundError: No module named ‘frontend’

This error usually happens when PyMuPDF is not installed correctly or there’s a conflict with an outdated version. The fitz module should import directly from PyMuPDF, but if you see from frontend import *, that indicates you’ve got a broken or mismatched installation.

Here’s how you can fix it:

✅ Steps to Resolve

1. Uninstall any broken versions
   pip uninstall fitz
pip uninstall PyMuPDF
   ⚠️ Note: There is a package called fitz on PyPI that is not PyMuPDF. If you installed that by mistake, it causes this exact error.
2. Install the correct package
   pip install --upgrade pip
pip install PyMuPDF
   The correct way to import is:
   import fitz # this comes from PyMuPDF
3. Verify installation
   Run:
   pip show PyMuPDF
   You should see something like:
   Name: PyMuPDF Version:
<latest version> Location: ...
4. Check for multiple Python environments
   • If you’re using Anaconda, venv, or system Python, make sure you’re installing PyMuPDF in the same environment you’re running your script.
   • You can check with: which python pip list

🛠 Quick Test

After reinstalling, try:

import fitz
doc = fitz.open()
print("PyMuPDF works!")

import fitz
doc = fitz.open()
print("PyMuPDF works!")

If that runs without error, your installation is fixed.

👉 In short: You accidentally installed the wrong fitz package. Remove it, then install PyMuPDF, and the error will disappear.