How to Turn Any Python Script into a Standalone EXE with PyInstaller

Introduction

This guide shows Python enthusiasts how to package their scripts into executable files that run on Windows without requiring a Python interpreter.

Installing PyInstaller

First, install PyInstaller using the command: pip3 install pyinstaller After installation, you will see a confirmation similar to the screenshot below.

How PyInstaller Packages

Python scripts cannot run independently of the interpreter, so PyInstaller bundles the interpreter, the script, and all required third‑party packages into a single .exe. Even if your project only uses requests, PyInstaller includes all its dependencies.

Creating a Simple EXE

Navigate to the directory containing your script and run: pyinstaller -F setup.py The

-F</p> option forces a fresh build each time. After execution, PyInstaller creates several folders; the <code>dist

folder contains the generated .exe.

Run the setup.exe located beside setup.py to verify it works without a Python environment.

Packaging a GUI Application

When packaging a PyQt5 GUI, add the -w flag to suppress the console window: pyinstaller -F -w setup.py To set a custom icon, include the -i option with an .ico file:

pyinstaller -F -w -i wind.ico setup.py

After packaging, the executable displays the specified icon.

Common Commands Summary

pyinstaller -F setup.py

– package script into a single exe. pyinstaller -F -w setup.py – package without a console window. pyinstaller -F -w -i xx.ico setup.py – package with a custom icon.

Conclusion

After upgrading pip to the latest version, install PyInstaller and follow the steps above to create portable executables for any Python script, even those with GUI components. This eliminates the need for a Python environment on the target machine.