Home › Python

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

Traceback (most recent call last):
  File "analysis.py", line 1, in <module>
    import pandas as pd
ModuleNotFoundError: No module named 'pandas'

Quick fix: Install it with the same interpreter that runs the script: python -m pip install pandas (or py -m pip install pandas on Windows, conda install pandas in conda). In Jupyter run %pip install pandas in a cell, then restart the kernel. In VS Code select the right interpreter.

What it means

Python searched every folder on sys.path for a package called pandas and didn't find one. Either pandas is not installed at all, or it is installed for a different Python than the one running your code. The second case is the usual one on machines with several Pythons (system, Homebrew, python.org, Anaconda, venvs).

See which interpreter is running:

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

Fix 1: install with python -m pip

Always install through the interpreter you run, so pip and Python match:

python -m pip install pandas
Platform Command
Windows py -m pip install pandas
macOS / Linux python3 -m pip install pandas
Inside an activated venv python -m pip install pandas
Anaconda / Miniconda conda install pandas

Verify:

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

If pip itself is missing, see pip: command not found.

Fix 2: externally-managed-environment on Debian/Ubuntu/macOS Homebrew

Newer system Pythons block pip install globally. Use a virtual environment:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install pandas

Or install the distro package: sudo apt install python3-pandas. Details on the externally-managed-environment page.

Fix 3: Jupyter Notebook / JupyterLab

The notebook kernel may use a different Python than your terminal. Install from inside the notebook:

%pip install pandas

Then Kernel → Restart. %pip installs into the kernel's own environment (unlike !pip, which may use another one). Check with:

import sys; print(sys.executable)

To use a venv as a kernel:

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

Fix 4: VS Code / PyCharm uses another interpreter

Running with the green "Run" button can use a different interpreter than your terminal.

Fix 5: sudo or cron runs a different Python

sudo python script.py uses root's environment, and cron uses a minimal PATH. Call the venv's interpreter by full path:

/home/me/project/.venv/bin/python script.py

Fix 6: a file named pandas.py

If the error changes to AttributeError: module 'pandas' has no attribute 'DataFrame' after installing, a local pandas.py (or a folder called pandas) is shadowing the library. Rename it and delete __pycache__.

Install fails?

On a very new Python version a wheel may not exist yet, so pip tries to compile from source and fails. Upgrade pip first (python -m pip install -U pip) or use a Python version pandas supports. See Failed building wheel.

Last updated 2026-11-14.