1127

I'm building a Python application and don't want to force my clients to install Python and modules.

So, is there a way to compile a Python script to be a standalone executable?

2
  • 535
    The part of the question that says "I don't want to force my clients to install Python and modules." It doesn't say the clients can't do it, it says the developer doesn't want to require them to do it. There's no point in debating the point here, because the clients are not reading SO to speak for themselves. I wouldn't want to install a Flash development environment just to watch youtube, or a C development environment just to play Sudoku, or a Python development environment to run a version of Angry Birds written in Python. That's what redistributable runtimes are for.
    – Dave
    Commented Nov 11, 2011 at 20:03
  • 1
    Would an answer including many files, but only one for running the application be acceptable? I'm thinking some sort of automation of packaging of the app + requirements with portable python distribution, and making an installation script to automate it.
    – Niko Fohr
    Commented Nov 16, 2020 at 19:22

19 Answers 19

617

You can use PyInstaller to package Python programs as standalone executables. It works on Windows, Linux, and Mac.

PyInstaller Quickstart

Install PyInstaller from PyPI:

pip install pyinstaller

Go to your program’s directory and run:

pyinstaller yourprogram.py

This will generate the bundle in a subdirectory called dist.

pyinstaller -F yourprogram.py

Adding -F (or --onefile) parameter will pack everything into single "exe".

pyinstaller -F --paths=<your_path>\Lib\site-packages  yourprogram.py

running into "ImportError" you might consider side-packages.

 pip install pynput==1.6.8

still runing in Import-Erorr - try to downgrade pyinstaller - see Getting error when using pynput with pyinstaller

For a more detailed walkthrough, see the manual.

16
  • 23
    It's worth noting that pyinstaller can compile to a single .exe file. Also on which OS it is run, makes that executable, i.e. .exe when run on Windows Commented Jun 6, 2014 at 14:17
  • 21
    As @GeenHenk said, if you "compile" on Windows it make a exe, get in mind that you can't compile for Windows (make an exe) on Linux, or make a Linux executable on Windows. You can only make the executable of the platform you are running. (In Linux you can use wine to trick this)
    – PhoneixS
    Commented Jan 13, 2015 at 8:24
  • 42
    using 'pyinstaller' is way easier than 'py2exe'. It takes care of every dependencies including numpy, pandas, anything and gives you a single executable on the working platform!
    – aks
    Commented Mar 9, 2016 at 5:00
  • 21
    Seems like exactly what I was looking for. And now supports Python 3! Thanks :) Commented Aug 30, 2016 at 8:23
  • 7
    I tried them all, the PyInstaller and others (py2exe, freeze, cython, embedded version of python and etc) still can't handle dependency of the python dynamic library itself at least in the Windows (python*.dll). The dll has dependency on the runtime which HAS TO BE installed separately. After the process you gain the executable which will be linked to the dll and so has the same importability. So your 'standalone' executable is not much standalone, but more like embeddable. To workaround the runtime dependency you HAVE TO rebuild the python from the source using cpython project.
    – Andry
    Commented Jul 13, 2017 at 8:33
303

You can use py2exe as already answered and use Cython to convert your key .py files in .pyc, C compiled files, like .dll in Windows and .so on Linux.

It is much harder to revert than common .pyo and .pyc files (and also gain in performance!).

10
  • 1
    Thanks for answer. I've considered Cython, but it seems it still need Python to run compiled executable. Do you mean compiling script to .pyc using Cython? (I didn't know if Cython has such feature)
    – Jeff
    Commented Mar 28, 2011 at 12:18
  • 11
    I mean you have two problems: closed source and no-deps. For closed source compile your important code in C libs using Cython. For no-deps use py2exe and make an executable with .pyd (cython compiled) files within.
    – neurino
    Commented Mar 28, 2011 at 12:24
  • 8
    What would you do about the libraries (numpy, scipy, matplotlib) ? For instance, how would clients be able to use the ginput() function in matplotlib from the executable, without having it installed on their computer. Commented Apr 10, 2013 at 18:04
  • @chimpsarehungry what about static linking? Commented Jan 28, 2015 at 7:15
  • 15
    Last release seem to be in 2008, is this still maintained ?
    – Zitrax
    Commented Sep 17, 2015 at 8:45
122

You might wish to investigate Nuitka. It takes Python source code and converts it in to C++ API calls. Then it compiles into an executable binary (ELF on Linux). It has been around for a few years now and supports a wide range of Python versions.

You will probably also get a performance improvement if you use it. It is recommended.

10
  • 11
    Nuitka is an awesome tool. No need not to use it. I'd only point out one thing - it's not limited to Linux only - it's cross-platform - another reason why to use it.
    – sjaustirni
    Commented Nov 20, 2014 at 16:09
  • 6
    Nuitka works on Python 2.6, 2.7, 3.2, 3.3, and 3.4, and is cross-platform:(Linux, FreeBSD, NetBSD, MacOS X, and Windows (32/64 bits). Others may work as well. Architectures: x86, x86_64 (amd64), and arm. Other architectures may also work, out of the box.) Commented Mar 15, 2015 at 1:33
  • 2
    Does this create a standalone executable?
    – voices
    Commented Jan 29, 2019 at 10:44
  • 1
    Worked pretty much out-of-the-box for me on Windows and I did get a pretty good performance improvement. Making a standalone executable failed, however :(
    – jkrei0
    Commented Aug 4, 2020 at 17:14
  • 1
    always gives an error and is broken beyond belief, would not recommend Commented Jun 30, 2022 at 11:18
49

Yes, it is possible to compile Python scripts into standalone executables.

PyInstaller can be used to convert Python programs into stand-alone executables, under Windows, Linux, Mac OS X, FreeBSD, Solaris, and AIX. It is one of the recommended converters.

py2exe converts Python scripts into only executable on the Windows platform.

Cython is a static compiler for both the Python programming language and the extended Cython programming language.

3
  • 3
    Thanks for this. I was using py2exe, and couldnt get the icons working with it at all. PyInstaller worked first time, and looks great!
    – Chud37
    Commented May 11, 2017 at 7:24
  • Can I create standalone executable from Windows for Linux and macOS? Or I should install Linux and macOS on VirtualBox? I do not have enough free space on my laptop.
    – 8Observer8
    Commented Apr 7, 2019 at 11:19
  • 1
    I found answer on my question in the documentation here: pyinstaller.readthedocs.io/en/stable/…
    – 8Observer8
    Commented Apr 7, 2019 at 11:26
35

I would like to compile some useful information about creating standalone files on Windows using Python 2.7.

I have used py2exe and it works, but I had some problems.

This last reason made me try PyInstaller http://www.pyinstaller.org/.

In my opinion, it is much better because:

  • It is easier to use.

I suggest creating a .bat file with the following lines for example (pyinstaller.exe must be in in the Windows path):

pyinstaller.exe --onefile MyCode.py

So, I think that, at least for python 2.7, a better and simpler option is PyInstaller.

1
  • 5
    The --onefile flag won't help you to make it portable on the Windows, because the executable still wants to link with the api-ms-win-crt-runtime-l1-1-0.dll library (or/and others) which must be installed through the vcredist package. So a dependency is still there and must be installed before the run.
    – Andry
    Commented Jul 13, 2017 at 11:13
35

And a third option is cx_Freeze, which is cross-platform.

3
  • 2
    Here we are in Feb of 2019 and there are no listed cx_Freeze releases on pypi since end of 2017. Was this project abandoned? Commented Feb 21, 2019 at 5:39
  • 1
    Sorry I know I'm a bit late (2020) but no, cx_Freeze is not abandoned! The maintainer is still pushing updates, although at a much slower rate.
    – Armster
    Commented Jun 19, 2020 at 20:59
  • To elaborate on the use of "cross-platform" here, from the docs: "cx_Freeze works on Windows, Mac, and Linux, but on each platform, it only makes an executable that runs on that platform. So if you want to freeze your programs for Windows, freeze it on Windows; if you want to run it on Macs, freeze it on a Mac."
    – jslatane
    Commented Dec 2 at 20:19
30
pyinstaller yourfile.py -F --onefile

This creates a standalone EXE file on Windows.

Important note 1: The EXE file will be generated in a folder named 'dist'.

Important note 2: Do not forget --onefile flag

You can install PyInstaller using pip install PyInstaller

Enter image description here

Enter image description here

NOTE: In rare cases there are hidden dependencies...so if you run the EXE file and get missing library error (win32timezone in the example below) then use something like this:

pyinstaller --hiddenimport win32timezone -F "Backup Program.py"
0
24

I like PyInstaller - especially the "windowed" variant:

pyinstaller --onefile --windowed myscript.py

It will create one single *.exe file in a distination/folder.

4
  • 1
    did you already try this on target machine without python? how is this get upvoted?
    – greendino
    Commented Jun 12, 2020 at 20:31
  • What do you mean, @AbdullahSaid? Why would someone use pyinstaller on a machine without Python on it?
    – cslotty
    Commented Jun 14, 2020 at 8:27
  • I didn't say that. what I meant is, if the executable gonna run on a machine without python installed in it. or should I say "customer PC", I already try it on my VM's without python and it just won't work, why would you create an installer for yourself is for? you meant to write it so other PC could install it without any dependency right?. read the title above
    – greendino
    Commented Jun 14, 2020 at 18:22
  • 3
    @AbdullahSaid The target system doesn't need Python installed separately, it's packed in the resulting exe-file. Otherwise this wouldn't make much sense. On execution, the exe file will unpack itself into its own temp-folder and take everything from there!
    – cslotty
    Commented Jun 15, 2020 at 11:12
18

You may like py2exe. You'll also find information in there for doing it on Linux.

2
  • 3
    But you will need to give it the package all option. Commented Mar 28, 2011 at 11:37
  • how is this get upvoted? are you already tried that or you just saying things based on your opinion
    – greendino
    Commented Jun 12, 2020 at 20:31
15

Use py2exe.... use the below set up files:

from distutils.core import setup
import py2exe

from distutils.filelist import findall
import matplotlib

setup(
    console = ['PlotMemInfo.py'],

    options = {
        'py2exe': {
            'packages': ['matplotlib'],
            'dll_excludes': ['libgdk-win32-2.0-0.dll',
                             'libgobject-2.0-0.dll',
            'libgdk_pixbuf-2.0-0.dll']
        }
    },
    data_files = matplotlib.get_py2exe_datafiles()
)
2
  • I did this and it created a python27.dll file and it is still required. I moved the .exe file out of the folder holding the python27.dll file and the .exe file no longer runs.
    – mjwrazor
    Commented Aug 16, 2016 at 14:58
  • Could you show such script for Linux and macOS? I want to create standalone executable files from Windows for Linux and macOS.
    – 8Observer8
    Commented Apr 7, 2019 at 11:22
14

I also recommend PyInstaller for better backward compatibility such as Python 2.3 - 2.7.

For py2exe, you have to have Python 2.6.

2
  • pyinstaller has import problems. For example: in my case, I'm in this DIR ~/Documents/python101/ and ex50_pycomp.py & ex50.py are in this dir. ex50_pycomp.py importing ex50.py. I run pyinstaller ex50_pycomp.py and i see all complied, produced dist. All good right? I cd into dist/ex50_pycomp/ and run ex50_pycomp it works. Once I put this ex50_pycom into a virtualmachine, then this says import error and in another other linux box it says " -bash: ./ex_50_pycom: cannot execute binary file: Exec format error" Commented Sep 18, 2018 at 4:31
  • prob1:I was using python2.7 but pyinstaller was talking with python3 python3 setup.py build python3 setup.py install your python3 will get all pkg_resources prob 3:if using sys_path becomes a problem so give your path like this pyinstaller --hidden-import=pkg_resources --onefile file.py --path=my_path rw-rw-r-- my_path:python3's dist folder pyinstaller --hidden-import=pkg_resources --onefile file.py --path=/usr/local/lib/python3.5/dist-packages/my_code_lib-0+untagged.8.gd264bd5.dirty-py3.5.egg/my_folder -rw-rw-r-- Commented Sep 29, 2018 at 19:53
11

Since it seems to be missing from the current list of answers, I think it is worth mentioning that the standard library includes a zipapp module that can be used for this purpose. Its basic usage is just compressing a bunch of Python files into a zip file with extension .pyz than can be directly executed as python myapp.pyz, but you can also make a self-contained package from a requirements.txt file:

$ python -m pip install -r requirements.txt --target myapp
$ python -m zipapp -p "interpreter" myapp

Where interpreter can be something like /usr/bin/env python (see Specifying the Interpreter).

Usually, the generated .pyz / .pyzw file should be executable, in Unix because it gets marked as such and in Windows because Python installation usually registers those extensions. However, it is relatively easy to make a Windows executable that should work as long as the user has python3.dll in the path.

If you don't want to require the end user to install Python, you can distribute the application along with the embeddable Python package.

1
  • This is a promissing option, but is there a starter repo or project to see it in action, also I couldn't overcome this point The embedded distribution does not include the Microsoft C Runtime Commented Jun 28, 2022 at 22:21
10

For Python 3.2 scripts, the only choice is cx_Freeze. Build it from sources; otherwise it won't work.

For Python 2.x I suggest PyInstaller as it can package a Python program in a single executable, unlike cx_Freeze which outputs also libraries.

0
7

py2exe will make the EXE file you want, but you need to have the same version of MSVCR90.dll on the machine you're going to use your new EXE file.

See Tutorial for more information.

7

You can find the list of distribution utilities listed at Distribution Utilities.

I use bbfreeze and it has been working very well (yet to have Python 3 support though).

3
  • stackoverflow.com/questions/33683133/… I use bbfreeze very nice package.
    – user914425
    Commented Dec 2, 2015 at 19:59
  • Does it take care of dependencies and install relevant py modules?
    – Volatil3
    Commented May 9, 2016 at 17:20
  • @Volatil3 Yes, all the dependencies are taken care of. WRT to installation of modules on the host system - there are different kinds of compilations. The bbfreeze will compile everything into multiple .so files, or copy the .egg files directly and they shall all be present in a single directory (or as a single file). There is no installation required.
    – Joe
    Commented Jul 26, 2016 at 8:16
6

Use Cython to convert to C, compile, and link with GCC.

Another could be, make the core functions in C (the ones you want to make hard to reverse), compile them and use Boost.Python to import the compiled code (plus you get a much faster code execution). Then use any tool mentioned to distribute.

5

Not exactly a packaging of the Python code, but there is now also Grumpy from Google, which transpiles the code to Go.

It doesn't support the Python C API, so it may not work for all projects.

1
  • it seems dead, at today's date.
    – luca76
    Commented Mar 23, 2021 at 9:38
5

Using PyInstaller, I found a better method using shortcut to the .exe rather than making --onefile. Anyway, there are probably some data files around and if you're running a site-based app then your program depends on HTML, JavaScript, and CSS files too. There isn't any point in moving all these files somewhere... Instead what if we move the working path up?

Make a shortcut to the EXE file, move it at top and set the target and start-in paths as specified, to have relative paths going to dist\folder:

Target: %windir%\system32\cmd.exe /c start dist\web_wrapper\web_wrapper.exe
Start in: "%windir%\system32\cmd.exe /c start dist\web_wrapper\"

We can rename the shortcut to anything, so renaming to "GTFS-Manager". Now when I double-click the shortcut, it's as if I python-ran the file! I found this approach better than the --onefile one as:

  1. In onefile's case, there's a problem with a .dll missing for the Windows 7 OS which needs some prior installation, etc. Yawn. With the usual build with multiple files, no such issues.
  2. All the files that my Python script uses (it's deploying a tornado web server and needs a whole freakin' website worth of files to be there!) don't need to be moved anywhere: I simply create the shortcut at top.
  3. I can actually use this exact same folder on Ubuntu (run python3 myfile.py) and Windows (double-click the shortcut).
  4. I don't need to bother with the overly complicated hacking of .spec file to include data files, etc.

Oh, remember to delete off the build folder after building. It will save on size.

1
  • Hi, just updating.. I decided to forgo UPX compression and go the --onefile way finally. Had to pick one, because UPX currently has a bug in compressing a particular DLL.
    – Nikhil VJ
    Commented Jan 4, 2019 at 23:05
1

I'm told that PyRun is also an option. It currently supports Linux, FreeBSD and Mac OS X.

1

Not the answer you're looking for? Browse other questions tagged or ask your own question.