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

Warning

It is not recommended to use pip in conda environment. See why in Using Pip in a Conda Environment .

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.

filelock >= 3.12.3
importlib_metadata >= 6     (Python 3.9-3.10.2)
packaging >= 24
setuptools >= 65.6.3        (setuptools >= 70.1 if installing from sources)
tomli >= 2.0.1              (Python 3.9-3.10)
typing_extensions >= 4.10.0 (Python 3.9)
patchelf >= 0.14            (Linux)
dmgbuild >= 1.6.1           (macOS)
cabarchive >= 0.2.4         (Windows only)
cx_Logging >= 3.1           (Windows only)
lief >= 0.13.2              (Windows only)
striprtf >= 0.0.26          (Windows only)
C compiler                  (required only if installing from sources)

Note

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

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 .