Python ModuleNotFoundError Reference — 198+ “No module named X” Fixes (2026)

itsourcecode.com hosts 198+ documented fixes for Python ModuleNotFoundError messages — the most common error every Python developer hits, from beginners running their first script to ML engineers wrestling with TensorFlow imports. Whether you see ModuleNotFoundError: No module named 'numpy', 'tensorflow', 'flask', or some obscure dependency, you’ll find the exact fix below organized by ecosystem. Each post shows the error, the root cause, and 2–4 alternative fixes.

What is ModuleNotFoundError?

A ModuleNotFoundError happens when Python’s import statement can’t find a module on the current Python interpreter’s path. It’s a subclass of ImportError, introduced in Python 3.6. The error message always tells you which module is missing in quotes — for example ModuleNotFoundError: No module named 'pandas'. The fix depends on why Python can’t find it: not installed, installed in a different Python, wrong virtualenv active, typo in the import, or a sub-module that doesn’t exist in the package version you have.

How to fix any ModuleNotFoundError in 5 steps

1. Read the exact module name in quotes. The error tells you what’s missing. Note the spelling — capitalization matters in Python (PIL vs pil, OpenCV vs cv2).
2. Confirm which Python you’re running. Run which python (Mac/Linux) or where python (Windows). Then python --version. If you have multiple Pythons, you may be importing from a different one than where the module is installed.
3. Try installing with pip. Run pip install . If that fails, try python -m pip install — this guarantees you’re using the pip that matches your active Python.
4. Check your virtualenv. If you’re using a virtualenv (venv, conda, poetry), make sure it’s activated before running pip install AND before running your script. Forgotten activation is the #1 cause of this error.
5. Verify the import name matches the package name. Some packages have different install and import names. Example: install pip install beautifulsoup4, but import as from bs4 import BeautifulSoup. Install pip install opencv-python, import as import cv2. Install pip install python-dotenv, import as from dotenv import load_dotenv.

Most common causes (in order of frequency)

• Module not installed — easy fix: pip install
• Wrong Python interpreter active — IDE running system Python but module installed in venv (or vice versa)
• Virtualenv not activated — module installed globally but venv is active, or installed in venv but venv isn’t active
• Install name ≠ import name — see the table above (bs4, cv2, dotenv, etc.)
• Sub-module removed in newer version — common with sklearn, keras, numpy as their internal APIs evolve
• Python core module disabled at build time — _ssl, _tkinter, _curses errors usually mean Python was compiled without those modules
• Python 2 → 3 migration — old codebases importing modules with renamed locations

Featured ModuleNotFoundError fixes by ecosystem

📊 Data Science (numpy, pandas, matplotlib, scikit-learn)

The Python data stack. Most errors here come from sub-module removals between major versions or pip/conda installation mismatches.

• No module named ‘matplotlib’
• No module named ‘sklearn.externals.six’
• No module named ‘numpy.testing.nosetester’
• No module named ‘pyspark.pandas’
• No module named ‘tabulate’
• No module named ‘prettytable’

🤖 Machine Learning & AI (TensorFlow, PyTorch, Keras, OpenCV, LangChain)

ML packages have the most install pain because of GPU/CPU variants, CUDA versions, and rapidly changing internal APIs.

• No module named ‘tensorflow’
• No module named ‘torchvision’ (PyTorch)
• No module named ‘keras.objectives’
• No module named ‘PIL’ (Pillow)
• No module named ‘langchain’
• No module named ‘einops’ — 2026 Guide
• No module named ‘groundingdino’ — 2026 Guide
• No module named ‘pinecone’
• No module named ‘taming’

🌐 Web Frameworks (Flask, Django, FastAPI)

Framework imports usually fail because the framework isn’t installed in the active venv, or you’re importing a sub-package that’s a separate pip install (Flask-CORS, flask_sqlalchemy, etc.).

• No module named ‘flask’
• No module named ‘flask_sqlalchemy’
• No module named ‘flask_cors’ — 2026 Guide
• No module named ‘fastapi’ — 2026 Guide
• No module named ‘aiohttp’
• No module named ‘django_filters’
• No module named ‘debug_toolbar’ (Django)

🗄️ Databases (PostgreSQL, MongoDB, MySQL)

Database connectors often need system libraries before they can be installed. psycopg2 needs libpq-dev on Linux; mysqlclient needs mysql-dev.

• No module named ‘psycopg2’ (PostgreSQL)
• No module named ‘pymongo’ (MongoDB)
• No module named ‘MySQL’ (Python 3)
• No module named ‘mysql’
• No module named ‘flask_sqlalchemy’

🖥️ GUI & Game (Tkinter, PyQt, Pygame)

Desktop GUI errors. _tkinter errors usually mean Python was compiled without Tk support — need to rebuild Python or use a different distribution.

• No module named ‘_tkinter’ — 2026 Guide
• No module named ‘PyQt5.QtWebKitWidgets’
• No module named ‘pygame’

🕷️ Web Scraping (BeautifulSoup, Selenium, Scrapy)

Web scraping has more “install name ≠ import name” gotchas than any other ecosystem. bs4 needs beautifulsoup4; webdriver_manager is its own package.

• No module named ‘bs4’ (BeautifulSoup)
• No module named ‘selenium’
• No module named ‘lxml’
• No module named ‘webdriver_manager’ — 2026 Guide

📦 pip, setuptools, Python core modules

The most painful errors — when Python itself can’t import its own tools. Usually means a broken Python install, missing system dependency, or virtualenv that’s gone bad.

• No module named ‘pip’ in Python
• No module named ‘pip’ on Windows
• No module named ‘pkg_resources’ — 2026 Guide
• No module named ‘setuptools.command.build’
• No module named ‘_ssl’
• No module named ‘_curses’ — 2026 Guide
• No module named ‘distutils.cmd’
• No module named ‘fcntl’ — 2026 Guide

🛠️ Utilities (dotenv, dateutil, click, docx)

Common helper packages. Most of these have classic install/import name confusion.

• No module named ‘dotenv’ (install: python-dotenv)
• No module named ‘python-dateutil’
• No module named ‘click’ — 2026 Guide
• No module named ‘crypto’
• No module named ‘docx’ — 2026 Guide
• No module named ‘ruamel’
• No module named ‘jwt’ — 2026 Guide

🤖 Bots, Notebooks, & Misc

• No module named ‘discord’ — 2026 Guide
• No module named ‘IPython’ — 2026 Guide
• No module named ‘google.colab’ — 2026 Guide

2026 Updated Guides — featured ModuleNotFoundError fixes

These guides were rewritten or expanded in 2026 with current package versions and step-by-step install instructions for Windows, Mac, and Linux.

• No module named ‘fastapi’ — FastAPI install guide
• No module named ‘flask_cors’ — Flask CORS setup
• No module named ‘click’ — Click CLI library
• No module named ‘docx’ — python-docx vs docx confusion
• No module named ‘discord’ — discord.py setup
• No module named ‘einops’ — tensor manipulation
• No module named ‘groundingdino’ — computer vision
• No module named ‘google.colab’ — Colab vs local Python
• No module named ‘IPython’ — Jupyter & notebooks
• No module named ‘jwt’ — PyJWT setup
• No module named ‘fcntl’ — Unix-only on Windows
• No module named ‘pkg_resources’ — setuptools broken
• No module named ‘_tkinter’ — Python compile flags
• No module named ‘_curses’ — terminal libraries
• No module named ‘webdriver_manager’ — Selenium driver auto-management
• No module named ‘debug_toolbar’ — Django toolbar

Related error categories

ModuleNotFoundError is one of 10 hubs in our Python & JavaScript error reference cluster — 980+ documented fixes total. If your error isn’t about a missing module, jump to the right hub below:

• TypeError Reference — 220+ Python & JS TypeError fixes (NoneType, not callable, JS undefined)
• AttributeError Reference — 173+ “object has no attribute X” fixes
• ValueError Reference — 100+ library-specific Python ValueError fixes
• ImportError Reference — 67+ “cannot import name X from Y” fixes (different from ModuleNotFoundError — for version conflicts where the package IS installed)
• NameError Reference — 49+ Python “name X is not defined” fixes
• RuntimeError Reference — 49+ PyTorch CUDA, asyncio, Flask runtime errors
• SyntaxError Reference — 48+ Python & JavaScript parsing errors
• ReferenceError Reference — 34+ JavaScript “is not defined” fixes
• HTTP Error Reference — 35+ HTTP status code fixes
• Python Tutorial — beginner-to-intermediate Python lessons

About this ModuleNotFoundError reference

This ModuleNotFoundError reference has been curated since 2015 by PIES Information Technology Solutions in Binalbagan, Negros Occidental, Philippines. Every post in the collection started as a real error encountered by us, our clients, or readers who emailed us with their tracebacks. Used by 12,000+ Python developers monthly across the Philippines, India, the United States, and beyond. If your error isn’t here, send the full traceback to our contact form and we’ll add it.