“Module Not Found” Error in Auto-Py-to-Exe

Auto-Py-to-Exe is a popular utility used by Python developers to convert their Python scripts into standalone executables. It simplifies the process of distributing Python applications by bundling all the required dependencies and resources into a single executable file. However, when working with Auto-Py-to-Exe, you might encounter the frustrating “Module Not Found” error. In this article, we will explore common causes of this error and provide troubleshooting steps to help you resolve it.

Understanding the “Module Not Found” Error in Auto-py-to-EXE:

The “Module Not Found” error typically occurs when Auto Py to Exe is unable to locate one or more Python modules that your script depends on. This error can manifest in different ways, with error messages like:

“ImportError: No module named ‘module_name'”


“ModuleNotFoundError: No module named ‘module_name'”.

It indicates that the specified module is either missing or not accessible during the conversion process.

Possible Causes of the Error:

Here are various possible causes for the “Module Not Found Error” that have been observed by users of Auto-py-to-Exe:

Missing or Misconfigured Dependencies:

One of the most common causes of the “Module Not Found” error is missing dependencies. If your Python script relies on external libraries or modules that are not installed or incorrectly specified, Auto-Py-to-Exe will fail to locate them during the conversion.

Virtual Environments:

If you are using a virtual environment for your Python project, it’s crucial to ensure that the environment is properly activated before running Auto-Py-to-Exe. Failing to activate the virtual environment can result in the “Module Not Found” error since the required modules might not be accessible outside the environment.

Multiple Python Versions:

Sometimes people have more than one Python installation on their devices. You may have developed your program using “Python Installation A”, but ran the Auto-py-to-EXE script using “Python Installation B”. If both installations have the exact same libraries, then there will likely be no issue. However, this is usually not the case.

File and Folder Structure:

Sometimes you may wish to import your own Python files (common to see in large applications which are broken down into several files). If the file paths are not correctly set up or if the module files are placed in non-standard locations, Auto-Py-to-Exe may struggle to find and include them in the final executable.

Troubleshooting Steps:

Check and Install Dependencies: Review your script’s dependencies and ensure that they are installed in the correct versions. Using a package manager like pip can help you install the required modules easily. Additionally, consider using a virtual environment to manage your project’s dependencies effectively.

To install any missing libraries, you can use the “pip install library_name” command.

Verify File and Folder Structure: Ensure that your script and all the necessary modules are organized in the expected file and folder structure. Double-check the locations of the modules, and if required, rearrange them to adhere to the standard structure. Refer to this guide on how to import modules from a different folder in Python.

Activate the Virtual Environment: If you are using a virtual environment, make sure to activate it before running Auto-Py-to-Exe. This ensures that the required modules are accessible during the conversion process. For more details on how to configure or activate a VM, refer to our tutorial on virtual environments in Python.

Specify Dependencies Manually: If Auto Py to Exe fails to identify the modules automatically, you can specify them manually using the “Hidden Imports” options in the Auto-Py-to-Exe interface. This way, you can explicitly include the required modules in the final executable.

Update Auto Py to Exe: Ensure that you are using the latest version of Auto-Py-to-Exe. Updates often include bug fixes and improvements that can help resolve known issues, including module-related errors. Run the command “pip install auto-py-to-exe –upgrade” to upgrade your installation.

Reinstall Auto-Py-to-Exe: Some users have reported that reinstalling auto-py-to-exe has helped resolved their problems. This could have been because of a corrupted or outdated library. You can try doing this as a last resort. Use “pip uninstall auto-py-to-exe” to uninstall, and “pip install auto-py-to-exe” to install it back.

This marks the end of the “Module Not Found” Error in Auto-Py-to-Exe tutorial. Any suggestions or contributions for CodersLegacy are more than welcome. Questions regarding the tutorial content can be asked in the comments section below.

Notify of
Inline Feedbacks
View all comments