PyInstaller Documentation
Release 3.2
David Cortesi
2016-05-03
Contents
1 What’s New This Release 3
1.1 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.2 License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.3 How To Contribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.4 How to Install PyInstaller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.5 What PyInstaller Does and How It Does It . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.6 Using PyInstaller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.7 Run-time Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
1.8 Using Spec Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
1.9 When Things Go Wrong . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
1.10 Advanced Topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
1.11 Understanding PyInstaller Hooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
1.12 Building the Bootloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
1.13 Changelog for PyInstaller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
1.14 Credits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
1.15 Man Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
1.16 Indices and tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
i
ii
PyInstaller Documentation, Release 3.2
Version PyInstaller 3.2
Homepage http://www.pyinstaller.org
Contact pyinstaller@googlegroups.com
Authors David Cortesi, based on structure by Giovanni Bajo & William Caban, based on Gordon McMil-
lan’s manual
Copyright This document has been placed in the public domain.
PyInstaller bundles a Python application and all its dependencies into a single package. The user can run the packaged
app without installing a Python interpreter or any modules. PyInstaller supports Python 2.7 and Python 3.3+, and
correctly bundles the major Python packages such as numpy, PyQt, Django, wxPython, and others.
PyInstaller is tested against Windows, Mac OS X, and Linux. However, it is not a cross-compiler: to make a Windows
app you run PyInstaller in Windows; to make a Linux app you run it in Linux, etc. PyInstaller has been used
successfully with AIX, Solaris, and FreeBSD, but is not tested against them.
Contents 1
