auto-py-to-exe

2.50.0 · active · verified Fri Apr 17

auto-py-to-exe is a Python library that provides a simple graphical interface for converting Python (.py) scripts into standalone executable files (.exe) using PyInstaller. It's currently at version 2.50.0 and maintains a frequent release cadence with minor and patch updates every few weeks, primarily focused on enhancements, bug fixes, and translations.

Common errors

```
Failed to execute script [script_name]
```
cause This error, originating from PyInstaller, often means that your bundled executable is missing a required runtime dependency (e.g., a data file, a dynamically loaded module, or a 'hidden import').

fix In the auto-py-to-exe GUI, go to the 'Add Files' tab to include data files, or the 'Advanced' tab to specify 'Hidden Imports' or 'Excluded Modules' that PyInstaller might miss.
```
The auto-py-to-exe application was unable to start: No browser found
```
cause The GUI for auto-py-to-exe uses the Eel library, which requires a compatible web browser (Chrome or Edge) to render the interface.

fix Install Google Chrome or Microsoft Edge on your system. If they are installed, ensure they are up-to-date and correctly recognized by your operating system.
```
ModuleNotFoundError: No module named 'Eel' (or 'PyInstaller')
```
cause This indicates that the core dependencies required for auto-py-to-exe to run were not installed correctly or have been corrupted.

fix Reinstall auto-py-to-exe using `pip install --upgrade auto-py-to-exe` to ensure all dependencies are correctly installed.

Warnings

gotcha Running auto-py-to-exe from the System32 directory on Windows can cause permission issues or unexpected behavior. It's recommended to run it from a standard user directory.
Fix: Launch auto-py-to-exe from any directory outside of `C:\Windows\System32`.
deprecated The `-m` option for specifying PyInstaller modules has been deprecated and is now hidden in the GUI.
Fix: Rely on PyInstaller's default module detection or specify hidden imports directly in the advanced options if needed.
gotcha Executables generated by PyInstaller (and thus auto-py-to-exe) may occasionally trigger false positives in antivirus software due to their packing methods. This is a common issue with many executable packers.
Fix: Inform users about the potential for false positives. Ensure the source script is legitimate and consider code signing for distribution.
gotcha The GUI relies on a modern web browser (Chrome or Edge in app mode) to function. If no compatible browser is found, the application may fail to start.
Fix: Ensure you have Google Chrome or Microsoft Edge installed and up-to-date on your system.

Install

pip install auto-py-to-exe Install auto-py-to-exe

Quickstart

Launch the graphical user interface to begin converting a Python script to an executable. This is the primary way to interact with the library.

auto-py-to-exe

view raw JSON →