Home › Python

ModuleNotFoundError: No module named 'matplotlib' (Python) — how to fix

Traceback (most recent call last):
  File "plot.py", line 1, in <module>
    import matplotlib.pyplot as plt
ModuleNotFoundError: No module named 'matplotlib'

Quick fix: Install with the interpreter that runs the code: python -m pip install matplotlib (Windows py -m pip install matplotlib, conda conda install matplotlib). In Jupyter run %pip install matplotlib in a cell and restart the kernel.

What it means

Python could not find a package named matplotlib on sys.path. Either it isn't installed, or it was installed for another Python: system vs Homebrew vs python.org vs Anaconda, or a venv. Notebooks make this more likely because the kernel often runs a different Python than your terminal.

python -c "import sys; print(sys.executable)"

Fix 1: install with python -m pip

python -m pip install matplotlib
Environment Command
Windows py -m pip install matplotlib
macOS / Linux python3 -m pip install matplotlib
Conda conda install matplotlib
Debian/Ubuntu system Python sudo apt install python3-matplotlib

Verify:

python -c "import matplotlib; print(matplotlib.__version__, matplotlib.__file__)"

If you get externally-managed-environment, create a venv first (python3 -m venv .venv && source .venv/bin/activate). See that page.

Fix 2: Jupyter / JupyterLab / Colab

Install into the kernel's environment from inside the notebook:

%pip install matplotlib

Then Kernel → Restart Kernel. %pip always targets the running kernel. !pip runs whatever pip is first on PATH, which may be a different Python. Check the kernel's interpreter with import sys; sys.executable.

To make a venv available as a kernel:

python -m pip install ipykernel
python -m ipykernel install --user --name myproject

Fix 3: VS Code / PyCharm / Spyder

Fix 4: No module named 'mpl_toolkits' or 'matplotlib.backends...'

Fix 5: install fails on a brand-new Python

If pip starts compiling matplotlib from source (you see Building wheel for matplotlib and compiler errors), there is no prebuilt wheel for your Python version or platform yet. Upgrade pip (python -m pip install -U pip) and try again, or use a slightly older Python. See Failed building wheel.

Fix 6: a file named matplotlib.py

A local matplotlib.py shadows the library and causes No module named 'matplotlib.pyplot'; 'matplotlib' is not a package. Rename the file and delete __pycache__.

Last updated 2026-11-15.