In a virtual environment, install by issuing the command:

pip install --upgrade cx_Freeze

Without virtual environment, depending on the system:

python -m pip install --upgrade cx_Freeze


python3 -m pip install --upgrade cx_Freeze

Python requirements

Python requirements are installed automatically by pip or conda.

  • cx_Logging >=3.0 (Windows only)

  • importlib-metadata

  • setuptools

Others requirements

  • C compiler - if installing from sources.

  • patchelf - in unix-like systems (Linux, FreeBSD, etc), except macOS.

To install patchelf in debian/ubuntu:

sudo apt-get install patchelf

To install patchelf in fedora:

dnf install patchelf

Or install patchelf from sources .. code-block:: console git clone -b 0.13 --single-branch cd patchelf ./ ./configure make make check sudo make install:


Using pipenv, install or update by issuing one of the folowing commanda:

pipenv install cx_Freeze
pipenv update cx_Freeze


Directly from the conda-forge channel:

conda install -c conda-forge cx_freeze

If you are installing a pre-release or from sources, install the requirements using the same channel:

  • python

  • c-compiler

  • libpython-static (for python >=3.8 in linux and macOS)

  • importlib-metadata

  • patchelf (optional if already installed in the Linux system)

  • declare SDKROOT or CONDA_BUILD_SYSROOT (for python 3.9 in macOS)

An example using Miniconda3:

# If using python 3.9 or higer in Github Actions CI, macOS, use this:
export SDKROOT=/Library/Developer/CommandLineTools/SDKs/MacOSX11.1.sdk

# For macOS and Linux
conda create -n cx39conda -c conda-forge python=3.9 libpython-static -y
conda activate cx39conda
conda install -c conda-forge c-compiler importlib-metadata -y
pip install --no-binary :all: --pre cx_Freeze -v

Download tarball or wheels

Download directly from PyPI.

Download the source code

You can download and extract the source code found on Github to do a manual installation.

In the source directory, use one of the command:

pip install -e .


python develop

Issue tracking on Github.