The MCUXpresso Installer Troubleshooting guide is designed to help users quickly identify and resolve common issues encountered during the installation of development software tools dependencies.

• Python Installation
• Python Virtual Environment
• Python-Tk Library

The installation process for Python can fail unexpectedly due to various reasons, usually related to system configuration.

• Manual deletion of Python folders before uninstalling
• Corrupted or incomplete Python installation
• Conflicts with Windows App Execution Aliases
• Missing registry entries or broken uninstall paths

Steps:

• Download the installer for the same Python version.
• Run the installer and choose Repair.
• After repair completes, run the installer again and choose Uninstall.

Steps:

• Open Settings → Apps → Installed Apps.
• Locate Python, click the three-dot menu → Modify.
• Choose Repair, then repeat and choose Uninstall.

Steps:

• Open Start → Manage App Execution Aliases.
• Disable all Python-related entries (e.g., python.exe, python3.exe).
• Retry installation or uninstallation.

Steps:

• Open System Properties → Environment Variables.
• Remove any PYTHONPATH or Python-related entries from both User and System variables.
• Delete folders like:
  • %USERPROFILE%\AppData\Local\Programs\Python\
  • %USERPROFILE%\AppData\Local\Programs\Python\PythonXX\Scripts\

Issues can be encountered during the creation, updating, activation, or usage of the Python virtual environment.

• Corrupted Python installation
• Corrupted virtual environment
• The already existing virtual environment is tied to a missing Python installation

• Make sure that the correct version of Python is installed and functional by following the Python Installation troubleshooting guide.
• Retry the creation of the virtual environment using the MCUXpresso Installer:
  • Open MCUXpresso Installer.
  • Perform a check for newer versions of components.
  • Install the Python dependencies for the desired package.

• Remove the existing virtual environment from %USERPROFILE%(or $HOME on Unix systems)/.mcuxpressotools/.venv.
• Make sure that the correct version of Python is installed and functional by following the Python Installation troubleshooting guide.
• Retry the creation of the virtual environment using the MCUXpresso Installer.
  • Open MCUXpresso Installer.
  • Perform a check for newer versions of components.
  • Install the Python dependencies for the desired package.

Issues regarding the python-tk (python3-tk) library can occur on systems where Python is installed via the system's package manager - APT (Ubuntu) or Homebrew (macOS).

• The Python installations from the system's package manager do not include the python-tk library.

• Open a terminal window
• Install the python3-tk library:
  sudo apt update
sudo apt install python3-tk
• Verify the installation:
  python3 -m tkinter

• Open a terminal window
• Install the python-tk library for your installed Python version (e.g. 3.10, 3.13):
  brew install python-tk@<VERSION>
• Verify the installation:
  python3 -m tkinter