pynsist 1.5

pynsist is a tool to build Windows installers for your Python applications. The installers bundle Python itself, so you can distribute your application to people who don’t have Python installed.

At present, pynsist requires Python 3.3 or above, or Python 2.7.


  1. Get the tools. Install NSIS, and then install pynsist from PyPI by running pip install pynsist.

  2. Write a config file installer.cfg, like this:

    name=My App
    # How to launch the app - this calls the 'main' function from the 'myapp' package:
    # Importable packages that your application requires, one per line
    packages = requests
    # Other files and folders that should be installed
    files = LICENSE
See The Config File for more details about this.
  1. Run pynsist installer.cfg to generate your installer. If pynsist isn’t found, you can use python -m nsist installer.cfg instead.


See also the examples folder in the repository.

The API is not yet documented here, because I’m still working out how it should be structured. The functions and classes have docstrings, and you’re welcome to use them directly, though they may change in the future.

Indices and tables