Compile and deploy Python application to binary file for Windows and Linux

Hey guys,
today I had to deploy a Python application for Windows and Linux users, which have
no Python distribution installed on their system. That’s why, I had to statically link
all used Python libraries and compile my Python application to a binary file.

There have been a few traps. For saving a bit of your time, I wrote this short How-To.
Ok, let’s say we have a Python script called ‘‘, which we want to deploy for Linux and Windows. We start with the Windows environment.

Compile Python application in Windows environment

For this task, I use the tool py2exe.

We can install the tool via easy_install. If you have easy_install not installed, you can get it by installing the setuptools.

easy_install py2exe

The configuration of py2exe can be done by creating a file called with the following content:

from distutils.core import setup
import py2exe

excludes = []
#includes = ["scipy.sparse.csgraph._validation", "scipy.spatial.kdtree", "scipy.sparse.csgraph._shortest_path"]
includes = []

opts = {
	"py2exe": {

setup(console=[''], pptions=opts)

You can add included paths in the respective line.
Of course, you also have to change the name of you python script.

Then you can compile your Python application via command line:

python py2exe

The compiling process should end with creating two folders (‘build’ and ‘dist’).
You only need to deploy the content of ‘dist’.

Now you are able to deploy all your Python applications to your Windows friends! *Hooray!*

But what about your friends using Linux? Just read on!

Compile Python application in Linux environment

Install patchelf(needed for bbfreeze)

tar xzf patchelf-0.6.tar.gz
cd patchelf-0.6
sudo make install

Install bbfreeze using easy_install (

sudo easy_install bbfreeze

Now you can configure bbfreeze within a created script file, e.g.

from bbfreeze import Freezer

f = Freezer("MyFancyApplication", includes="_strptime",))
f() # starts freezing process

Now we can compile the Python application by calling:


Now there should be a folder named ‘MyFancyApplication‘ containing the binary and all libs.

Your binary still depends on the version of your standard libs (libc, etc.). So try to build the application on a computer with old standard libs, since newer ones on other computers are backward-compatible, but not the other way round! In my case, I ran the compilation in Ubuntu 10.04, although 12.04 is up-to-date.

So long! Good luck!