modulenotfounderror: no module named src

In this post, you will learn the solutions to solve the error Modulenotfounderror: no module named ‘src’.

Actually, all programmers in python may encounter this error because the Python interpreter cannot find a module that your code is trying to import from a subdirectory named “src”

Also read the other solved error in python: Modulenotfounderror: no module named dotenv [SOLVED]

What is src in Python?

In Python, “src” is not a built-in keyword or function. It is mostly used as a shortcut of “source”, which refers to the source code of a program or module.

What are the possible reasons for this error no module named src?

The possible reasons for this error no module named src which are the following:

• The module you are trying to import does not exist.
• The module is located in a subdirectory named “src” and you forget to include the subdirectory in the import statement.
• The module is located in a virtual environment or in a conda environment which is not currently activated.
• The subdirectory named “src” does not exist in the directory where your Python script is located.
• The subdirectory named “src” exists, but it is not on your Python path.
• You misspelled the name of the module when you were trying to import it.
• The module that you are trying to import is haven’t been installed on your system.
• You are running your script from a different directory than the one where the script and “src” directory are located.

How to solve the error Modulenotfounderror: no module named ‘src’?

Diagnostic checklist for “No module named ‘src'”

• Verify pip install target. Run pip show src — if not installed, run pip install src.
• Check the active Python interpreter. which python (mac/Linux) or where python (Windows). Both pip and python must point to the same environment.
• Check virtual environment activation. If you use venv/conda, activate before installing: source .venv/bin/activate.
• Rule out uppercase/lowercase. Python imports are case-sensitive: import PyPDF2 not import pypdf2.
• Rule out the pip-vs-package-name mismatch. Some packages install under a different name than you import (e.g. pip install beautifulsoup4 → import bs4).

Installing src

# Standard pip install
pip install src

# In a virtual environment (recommended)
python -m venv .venv
source .venv/bin/activate  # or .venv\Scripts\activate on Windows
pip install src

# With uv (faster alternative)
uv pip install src

Common causes for “No module named ‘src'”

• Python interpreter mismatch. Multiple Python installations can confuse pip. Verify with which python and which pip.
• Virtual environment not activated. If the venv isn’t activated, pip installs to your system Python instead.
• Notebook kernel mismatch. Jupyter uses a kernel that may differ from your terminal Python. Use %pip install src inside the notebook.
• Import name differs from install name. pip install beautifulsoup4 → import bs4. Check the package’s PyPI page.
• Windows PATH issues. Ensure Python is on PATH; use python -m pip install to invoke pip via the correct Python.

Working code example

# Verify install worked
import src
print(getattr(src, '__version__', 'no version attribute'))

Best practices

• Always use a virtual environment. Avoids most module-not-found errors.
• Use pip freeze to lock versions. pip freeze > requirements.txt makes your setup reproducible.
• Consider uv or Poetry. Modern package managers with better dep resolution and reproducibility.

Conclusion

To conclude, by following the steps above, you should be able to resolve the error ModuleNotFoundError: No module named src.

For identifying the specific reason why the no module named src error occurred.

You can take the applicable solution above to resolve to error you encountered

Adones Evangelista

Programmer & Technical Writer at PIES IT Solution

Adones Evangelista is a programmer and writer at PIES IT Solution, author of over 900 tutorials and error-fix guides at itsourcecode.com. Specializes in JavaScript, Django, Laravel, and Python error debugging covering ValueError, TypeError, AttributeError, ModuleNotFoundError, and RuntimeError, plus C/C++ and PHP capstone projects for BSIT students.

Expertise: JavaScript · Python · Django · Laravel · Error Debugging · C/C++
 · View all posts by Adones Evangelista →