In this short guide, you’ll see how to create an executable of a Python script using cx_Freeze.
The following video tutorial is also included:
Here are the full steps to create an executable on Windows.
Steps to Create an Executable using cx_Freeze
Step 1: Add Python to Windows Path
If you haven’t already done so, add Python to Windows path.
You can add Python to the path by downloading a recent version of Python, and then checking the box to ‘Add Python to PATH’ at the beginning of the installation:
Add Python to PATH
Finish the installation, and you should be good to go.
Step 2: Install the cx_Freeze Package
Next, open the Windows Command Prompt and then type the following command to install the cx_Freeze package:
pip install cx_Freeze
Step 3: Save your Python Script
Now save your Python script at your desired location.
For example, let’s create a simple Python script that displays ‘Hello World’ when clicking a button:
import tkinter as tk root = tk.Tk() canvas1 = tk.Canvas(root, width=300, height=300) canvas1.pack() def hello(): label1 = tk.Label( root, text="Hello World", fg="blue", font=("helvetica", 12, "bold") ) canvas1.create_window(150, 200, window=label1) button1 = tk.Button(text="Click Me", command=hello, bg="brown", fg="white") canvas1.create_window(150, 150, window=button1) root.mainloop()
For demonstration purposes, let’s say that the Python script is stored in the following folder:
Where the Python script is called ‘hello‘ and the file extension is ‘.py‘
Step 4: Create the Executable using cx_Freeze
Now you’ll be able to create the executable of the Python script using cx_Freeze.
Simply go to the Command Prompt, and then type:
cd followed by the location where your Python script is stored
Here is the command for our example:
Then, refer to the following template to create the executable:
cxfreeze my_script.py --target-dir dist
Since for our example, the my_script is ‘hello‘ (and the file extension is .py), then the command to create the executable is:
cxfreeze hello.py --target-dir dist
Press Enter for the last time.
Step 5: Run the Executable
Your executable will be created at the location that you specified.
For our example, it will be under the same folder where the ‘hello’ script was originally stored:
You’ll notice that the dist folder was created at that location.
To find the executable file, open the dist folder. You’ll then see the executable file:
Double click on the file, and you should be able to launch your program.
In our case, once you click on the ‘hello’ executable, you’ll get a display with a single button.
And if you click on that button, you’ll see the following expression:
You can read more about cx_Freeze by visiting the cx_Freeze manual.