How to Fix The Module Not Found Error

Last Updated : 1 Jul, 2026

A ModuleNotFoundError, occurs when Python cannot locate the module you are trying to import. This usually happens when the module is not installed, the module name is incorrect, or Python cannot find it in its search path.

Python 
import mymodule

Output

ERROR!
Traceback (most recent call last):
File "<main.py>", line 1, in <module>
ModuleNotFoundError: No module named 'mymodule'

Explanation: Python searches for the specified module in its installed packages and project directories. If it cannot find the module, it raises a ModuleNotFoundError.

Common Causes

1. Module is Not Installed: One of the most common reasons is attempting to import a package that is not installed in the current Python environment.

Python 
import pandas

Output

ERROR!
Traceback (most recent call last):
File "<main.py>", line 1, in <module>
ModuleNotFoundError: No module named 'pandas'

Explanation: Python cannot find the pandas package because it is not installed in the active environment.

2. Incorrect Module Name or Spelling: Python is case-sensitive, so even a small spelling mistake can cause this error.

Python 
import pands

Output

ERROR!
Traceback (most recent call last):
File "<main.py>", line 1, in <module>
ModuleNotFoundError: No module named 'pands'

Explanation: correct package name is pandas, but pands was used. Since no module with that name exists, Python raises an error.

3. Importing a Module That Does Not Exist: Trying to import a completely nonexistent module also results in a ModuleNotFoundError.

Python 
import tiger

Output

ERROR!
Traceback (most recent call last):
File "<main.py>", line 1, in <module>
ModuleNotFoundError: No module named 'tiger'

Explanation: module tiger is not available in Python's standard library or installed packages.

4. Module Not Available in the Current Environment: A module may be installed in one Python environment but unavailable in another.

Python 
import numpy

Output

ERROR!
Traceback (most recent call last):
File "<main.py>", line 1, in <module>
ModuleNotFoundError: No module named 'numpy'

Explanation: package may be installed globally or in another virtual environment, but not in the currently active one.

Fixing ModuleNotFoundError

1. Check Whether the Module is Installed: You can use a try-except block to verify whether a module exists.

Python 
try:
    import pandas
    print("Module is installed.")
except ModuleNotFoundError:
    print("Module is not installed.")

Output

Module is not installed.

Explanation: code attempts to import the module. If Python cannot find it, the exception is caught and a friendly message is displayed.

2. Install the Missing Module: If the module is not installed, install it using pip.

pip install pandas

Explanation: pip install command downloads and installs the required package into the current Python environment.

3. Verify the Module Search Path: Python searches for modules in directories listed in sys.path.

Python 
import sys
print(sys.path)

Output

['project_folder', 'python_directory', ...]

Explanation: output shows all locations Python checks while importing modules. If your module's location is missing, Python will not be able to find it.

4. Check Installed Packages: You can list all installed packages and their versions.

pip list

Explanation: This command helps verify whether the required package is installed and which version is currently available.

5. Upgrade or Downgrade a Package: Sometimes a package version may not be compatible with your project.

Upgrade Package

pip install --upgrade package_name

Install a Specific Version

pip install package_name==1.0.0

Explanation: Installing the required version ensures compatibility between your code and the package.

Comment

Explore