ModuleNotFoundError: No Module Named ‘pkg_resources’ — Causes, & Fixes

Python developers often encounter the ModuleNotFoundError: No module named ‘pkg_resources’ error while installing packages, running scripts, working with virtual environments, or executing applications that depend on third-party libraries. This error typically indicates that the pkg_resources module, which is provided by the setuptools package, is either missing, outdated, corrupted, or inaccessible in the current Python environment.

Although the error message appears simple, it can stem from multiple issues, such as an incomplete Python installation, an improperly configured virtual environment, incompatible package versions, or problems with the Python interpreter being used.

In this guide, you’ll learn what the “No module named ‘pkg_resources'” error means, why it occurs, how to fix it step by step on Windows, macOS, and Linux, and the best practices to prevent it in future Python projects.

What is pkg_resources?

pkg_resources is a module provided by the setuptools package. It allows Python applications to discover installed packages, check package versions, load package resources, and manage dependencies at runtime.

Many third-party libraries rely on pkg_resources internally. If setuptools is missing or damaged, importing pkg_resources fails, resulting in the following error:

ModuleNotFoundError: No module named 'pkg_resources'

Although developers rarely import pkg_resources directly, many popular libraries such as pip, virtualenv, pytest, and packaging tools depend on it behind the scenes.

What Causes “No Module Named ‘pkg_resources'”?

The error can occur for several reasons, ranging from missing packages to incorrect Python environments. Understanding the root cause makes troubleshooting much easier.

In most cases, reinstalling setuptools resolves the problem, but sometimes the issue lies with the virtual environment or interpreter configuration.

How to Fix ModuleNotFoundError: ‘pkg_resources’?

The best way to solve the error is to verify your Python environment first and then reinstall or upgrade setuptools if necessary.

Follow these troubleshooting steps in order.

python --version

python3 --version

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

pip show setuptools

Name: setuptools
Version: 75.0.0
Location: /usr/local/lib/python3.x/site-packages

pip install setuptools

pip install --force-reinstall setuptools

pip install --upgrade setuptools

python

import pkg_resources
print(pkg_resources.__version__)

python -m pip install --upgrade pip

python -m pip install --upgrade setuptools

rm -rf venv

rmdir /s /q venv

python -m venv venv

venv\Scripts\activate

source venv/bin/activate

pip install -r requirements.txt

python -m pip list

pip install setuptools

python -m pip install setuptools

Fix the Error on Windows

Windows users commonly encounter this issue after installing multiple Python versions.

Verify Python:

where python

Install setuptools:
python -m pip install --upgrade setuptools

If using the Python Launcher:

py -m pip install setuptools

Restart Command Prompt after installation.

Fix the Error on macOS

macOS users should verify whether they’re using:

1. System Python
2. Homebrew Python
3. pyenv
4. Virtual Environment

Upgrade setuptools:

python3 -m pip install --upgrade setuptools

If using Homebrew:

brew update
brew upgrade python

Then reinstall setuptools.

Fix the Error on Linux

Linux distributions sometimes separate Python packages into system packages.

Ubuntu/Debian:

sudo apt update
sudo apt install python3-setuptools

Or install via pip:

python3 -m pip install setuptools

Common Scenarios That Trigger the Error

The error appears in many development workflows.

Understanding these situations helps identify the solution faster.

import pkg_resources

ModuleNotFoundError: No module named 'pkg_resources'

ModuleNotFoundError: No module named 'pkg_resources'

pip install -r requirements.txt

Common Mistakes to Avoid

Many developers fix the wrong Python installation or accidentally mix package managers.

Avoid these common mistakes.

pip install setuptools

python -m pip install setuptools

pip uninstall setuptools

How Moon Technolabs Helps with Python Development?

Moon Technolabs helps businesses build scalable Python applications, automation tools, APIs, AI solutions, and cloud-native platforms using modern development practices. Our Python experts troubleshoot dependency issues, optimize virtual environments, implement CI/CD pipelines, and ensure reliable package management across development and production environments.

Whether you’re developing web applications with Django or Flask, building machine learning solutions, or automating workflows with Python, Moon Technolabs delivers secure, maintainable, and high-performance solutions tailored to your business needs.

Conclusion

The ModuleNotFoundError: No module named ‘pkg_resources’ error is usually caused by a missing or corrupted setuptools installation, an incorrect Python interpreter, or a broken virtual environment. While the error may seem intimidating, it is typically resolved by verifying your Python environment, reinstalling or upgrading setuptools, and ensuring packages are installed in the correct interpreter.

Following best practices such as using virtual environments, keeping pip and setuptools updated, and installing packages with python -m pip can prevent similar dependency issues in future projects. By understanding how Python manages packages and environments, developers can resolve this error quickly and maintain a more stable development workflow.