Modulenotfounderror: no module named ‘pyautogui’

Encountering an error stating modulenotfounderror: no module named ‘pyautogui’ in Python?

Looking for a solution to fix this error? Read on to solve your problem.

In this article, we will show you how to solve the modulenotfounderror: no module named ‘pyautogui’.

This error indicates that the ‘pyautogui‘ module is not installed in your system or Python environment.

What is Python?

Python is one of the most popular programming languages.

It is used for developing a wide range of applications.

In addition, Python is a high-level programming language that is used by most developers due to its flexibility.

Returning to our issue, we must take a few actions to fix this error.

So, without further ado, let’s move on to our “how to fix this error” tutorial.

How to solve “no module named ‘pyautogui’” in Python

See also: Modulenotfounderror no module named tabulate

How to install PyAutoGUI on macOS or Linux

The following are the steps on how to install pyautogui on macOS or Linux:

→ Search for Terminal and open it.
→ Next, input the command pip install pyautogui, then click the enter key.

If you get an error saying “pip” isn’t found, use the command python -m.

It will look like this: python -m pip install pyautogui.

However, if you get a permissions error, use the command sudo pip install pyautogui.

Installing the pyautogui module on different platforms

The following are the commands you can use to install the pyautogui module on your system if you’re using a different platform.

✅ Jupyter Notebook

→ If you’re using Jupyter Notebook, use the command:

!pip install pyautogui

✅ Anaconda

→ If you’re using Anaconda, use the command:

conda install -c conda-forge pyautogui

✅ Py Alias

→ If you’re using py alias, use the command:

py -m pip install pyautogui

Commands you might need

• pip list
  
  This command will display all the packages installed on your system, including their versions.

  If you’re using Jupyter Notebook, use the !pip list command.

  However, if you’re using Anaconda, use the command conda list.

• python -m
  
  Include this command in your pip install pyautogui command if you get an error message stating that “pip” cannot be found.

  Example: python -m pip install pyautogui

  However, if you’re using Python 3, use the command python3 -m pip install pyautogui.

• pip install –upgrade pip
  
  Use this command to upgrade the pip package manager to its newest version.

  If your pip is already in the latest version, this will come out: “Requirement already satisfied.”

• python –version
  
  Use this command if you want to check what version of Python you have.

Diagnostic checklist for “No module named ‘pyautogui'”

• Verify pip install target. Run pip show pyautogui — if not installed, run pip install pyautogui.
• 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 pyautogui

# Standard pip install
pip install pyautogui

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

# With uv (faster alternative)
uv pip install pyautogui

Common causes for “No module named ‘pyautogui'”

• 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 pyautogui 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 pyautogui
print(getattr(pyautogui, '__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

In conclusion, the modulenotfounderror: no module named ‘pyautogui’ can be easily solved by installing the ‘pyautogui‘ module in your system.

By following the guide above, there’s no doubt that you’ll be able to resolve this error quickly.

We hope you’ve learned a lot from this.

Thank you for reading!

Elijah Galero

Programmer & Technical Writer at PIES IT Solution

Elijah Galero is a programmer and writer at PIES IT Solution, author of 175+ tutorials at itsourcecode.com. Specializes in Python error debugging (AttributeError, TypeError, ModuleNotFoundError), Python programming tutorials, and Microsoft Excel how-to guides for BSIT students and productivity learners.

Expertise: Python · Python Errors · Python AttributeError · Python TypeError · ModuleNotFoundError · MS Excel · MS PowerPoint
 · View all posts by Elijah Galero →