Freeze (package) Python programs into stand-alone executables
Clone or download
htgoebel Hooks: Correct name for nltk runtime-hook.
[skip ci] no test-case for this hook
Closes #3925.
Latest commit 5edb4f7 Dec 13, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Fix grammar in issue template. Jul 17, 2017
PyInstaller Hooks: Correct name for nltk runtime-hook. Dec 13, 2018
bootloader Fix broken Gmane URLs in comments. Dec 1, 2018
doc doc: Update When Things Go Wrong. Nov 25, 2018
news Hooks: Add hook for Pendulum. Dec 9, 2018
old Fix several ResourceWarning: unclosed file. Sep 9, 2018
scripts Remove outdated release-helper scripts. Sep 10, 2018
tests Hooks: Add hook for Pendulum. Dec 9, 2018
.dockerignore Tests: Add script and dockerfile for running tests in docker. May 29, 2018
.gitattributes Fix typo. Jun 3, 2017
.gitignore Misc: Revert changes to .gitignore. Nov 5, 2018
.landscape.yml Update .pylintrc and .landscape.yml Mar 29, 2016
.pylintrc Tests: Clean-up outdated modules from pylint-blacklist. Feb 20, 2018
.pyup.yml Tests/CI: Fix .pyup.yml syntax error. Nov 4, 2018
.travis.yml Test/CI: Make sure a failure inside an if statement produces a failed… Sep 3, 2018
COPYING.txt Update copyright-year. Mar 21, 2018 Adopt template for towncrier to our needs. Sep 6, 2018
README.rst Revert "Update versions in README." Sep 9, 2018
appveyor.yml Test/CI: Run more tests in non-library Appveyor tests to balance test… Sep 5, 2018 Update copyright-year. Mar 21, 2018 Update copyright-year. Mar 21, 2018 Update copyright-year. Mar 21, 2018 Update copyright-year. Mar 21, 2018 Update copyright-year. Mar 21, 2018 Update copyright-year. Mar 21, 2018
pyproject.toml Configure towncrier. Sep 6, 2018
requirements.txt Add a pip 'requirements.txt' file. Apr 3, 2018 Update copyright-year. Mar 21, 2018
setup.cfg Release: Do not create an (universal) wheel. Sep 11, 2018 Revert "setup: Remove hack required to not fail when pypiwin32 isn't … Oct 4, 2018


PyInstaller Overview

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.

Bitcoin: 1JUFjawzWDR7Tc8z9TKXstVFdjkDY9FbtK

PyInstaller reads a Python script written by you. It analyzes your code to discover every other module and library your script needs in order to execute. Then it collects copies of all those files -- including the active Python interpreter! -- and puts them with your script in a single folder, or optionally in a single executable file.

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.

Main Advantages

  • Works out-of-the-box with any Python version 2.7 / 3.4-3.7.
  • Fully multi-platform, and uses the OS support to load the dynamic libraries, thus ensuring full compatibility.
  • Correctly bundles the major Python packages such as numpy, PyQt4, PyQt5, PySide, Django, wxPython, matplotlib and others out-of-the-box.
  • Compatible with many 3rd-party packages out-of-the-box. (All the required tricks to make external packages work are already integrated.)
  • Libraries like PyQt5, PyQt4, PySide, wxPython, matplotlib or Django are fully supported, without having to handle plugins or external data files manually.
  • Working code signing on OS X.
  • Bundles MS Visual C++ DLLs on Windows.


PyInstaller is available on PyPI. You can install it through pip:

pip install pyinstaller

Requirements and Tested Platforms

  • Python:
  • 2.7 or 3.4-3.7
  • PyCrypto 2.4+ (only if using bytecode encryption)
  • Windows (32bit/64bit):
  • Windows XP or newer.
  • Linux (32bit/64bit)
  • ldd: Console application to print the shared libraries required by each program or shared library. This typically can be found in the distribution-package glibc or libc-bin.
  • objdump: Console application to display information from object files. This typically can be found in the distribution-package binutils.
  • objcopy: Console application to copy and translate object files. This typically can be found in the distribution-package binutils, too.
  • Mac OS X (64bit):
  • Mac OS X 10.7 (Lion) or newer.


Basic usage is very simple, just run it against your main script:

pyinstaller /path/to/

For more details, see the manual.

Untested Platforms

The following platforms have been contributed and any feedback or enhancements on these are welcome.

  • FreeBSD
  • ldd
  • Solaris
  • ldd
  • objdump
  • AIX
  • AIX 6.1 or newer. PyInstaller will not work with statically linked Python libraries.
  • ldd
  • PowerPC Linux (Debian)

Before using any contributed platform, you need to build the PyInstaller bootloader, as we do not ship binary packages. Download PyInstaller source, and build the bootloader:

cd bootloader
python ./waf distclean all

Then install PyInstaller:

python install

or simply use it directly from the source (