Differences between revisions 1 and 2
Revision 1 as of 2014-06-08 00:16:20
Size: 3723
Editor: DavidBoddie
Revision 2 as of 2014-06-08 00:17:26
Size: 3752
Editor: DavidBoddie
Deletions are marked like this. Additions are marked like this.
Line 19: Line 19:
 * [[PyInstallerOnMacOSX]]  * [[PyQt/PyInstallerOnMacOSX|PyInstaller On Mac OS X]]

Deploying PyQt Applications

This page contains information about some of the tools that could be used to deploy PyQt applications on various platforms, typically in binary form.

The idea is that each solution should be listed along with a brief description and a link to its home page. The description should probably come from the solution's home page or documentation, so that it is described "in its own words". Further comments and links for each can be given after these fields.

Cross-Platform Solutions

The following tools are cross-platform, working on Windows and some flavours of Unix.



  • "PyInstaller is a program that converts (packages) Python programs into stand-alone executables, under Windows, Linux and Irix."

A short How-To for using PyInstaller with PyQt on Mac OS-X:



  • "cx_Freeze is a set of utilities for freezing Python scripts into executables using many of the techniques found in Thomas Heller's py2exe, Gordon McMillan's Installer and the Freeze utility that ships with Python itself."


(Windows, Unix, but not Mac OS X)


  • "bbfreeze creates stand-alone executables from python scripts. It's

similar in purpose to the well known py2exe_ for windows, py2app_ for OS X, PyInstaller_ and cx_Freeze_ (in fact ancient versions were based on cx_Freeze. And it uses the modulegraph_ package, which is also used by py2app)."

Mercurial repository: http://systemexit.de/repo/bbfreeze


The original freeze tool that embeds Python bytecode into executables is supplied with Python - look in the examples/Tools directory.


For applications that don't depend too much on many shared library modules other than the ones shipped with PyQt, it may be possible to take advantage of qmake's features and a simple launcher application to create binaries for different platforms.

Tools for Windows

The following tools are designed to produce executables for Windows.



  • "py2exe is a Python Distutils extension which converts Python scripts into executable Windows programs, able to run without requiring a Python installation."

Comments: I highly recommend py2exe which can produce nice executables. Combined with InnoSetup, you get a full standard windows application and the user has no idea that the stuff was actually developed on Linux with Open Source technologies. -- Philippe Fremy

See the following links for more information about deploying PyQt applications with py2exe:



  • "ExeMaker is a small tool that takes a Python script, copies it to a program directory, and creates a Windows EXE file in the same directory."

Tools for Mac OS X

The following tools are designed to produce executables for Mac OS X.



  • "A distutils extension which converts python scripts into executable Mac OS X applications, able to run without requiring an existing Python installation."

Other Resources

How can I create a stand-alone binary from a Python script? from the pyfaq

PyQt/Deploying_PyQt_Applications (last edited 2018-05-30 06:30:34 by MichaelHerrmann)

Unable to edit the page? See the FrontPage for instructions.