Installation

Choose the Python package manager according to your system. See how the installation works with the most common ones.

To install the latest version of cx_Freeze using pip into a virtual environment:

pip install --upgrade cx_Freeze

Note

The recommended way to use cx_Freeze is in a virtual environment such as those provided by python -m venv , uv venv or conda . If you’re unfamiliar with Python virtual environments, check out the packaging user guide .

Important

Please note that some operating systems might be equipped with the python3 and pip3 commands instead of python and pip (but they should be equivalent).

Python requirements

Python requirements are installed automatically by pip or conda.

freeze-core >= 0.4.0
packaging >= 24
setuptools >= 78.1.1,<81
tomli >= 2.0.1           #  Python 3.10, Python 3.11+ has tomllib
filelock >= 3.15.3       #  Linux
patchelf >= 0.14,<0.18   #  Linux
dmgbuild >= 1.6.1        #  macOS
lief >= 0.15.1           #  Windows
python-msilib >= 0.4.1   #  Python 3.13+ on Windows

Note

  1. If you have trouble with patchelf, check How to install Patchelf.

  2. lief in conda-forge is named py-lief.

Download the source code

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

Issue tracking

Bug report and issue tracking on Github issues .