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.


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



(Windows, Unix, but not Mac OS X)

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:


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.


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:


Tools for Mac OS X

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


Other Resources

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

PyQt/Deploying_PyQt_Applications (last edited 2014-06-08 00:17:26 by DavidBoddie)

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