How to Install `wxPython` in Python

v4.2.5 General Purpose Python >=3.10

Cross platform GUI toolkit for Python, "Phoenix" version

Install pip install wxPython

What is wxPython?

Cross platform GUI toolkit for Python, "Phoenix" version

Welcome to wxPython's Project Phoenix! Phoenix is the improved next-generation wxPython, "better, stronger, faster than he was before." This new implementation is focused on improving speed, maintainability and extensibility. Just like "Classic" wxPython, Phoenix wraps the wxWidgets C++ toolkit and provides access to the user interface portions of the wxWidgets API, enabling Python applications to have a native GUI on Windows, Macs or Unix systems, with a native look and feel and requiring very little (if any) platform specific code.

For more information please refer to the , the , or the .

Archive files containing a copy of the wxPython documentation, the demo and samples, and also a set of MSVC .pdb files for Windows are available .

PyPI page → Author: Robin Dunn <[email protected]>, Scott Talbert <[email protected]>

Quick Start

Minimal example to get started with wxPython:

import wxpython

print(wxpython.__version__)

Installation

pip (standard)

pip install wxPython

Virtual environment (recommended)

python -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate
pip install wxPython

pip3

pip3 install wxPython

conda

conda install -c conda-forge wxPython

Poetry

poetry add wxPython

Dependencies

Installing wxPython will also install these packages:

numpy typing-extensions

Verify the Installation

After installing, confirm the package is available:

python -c "import wxpython; print(wxpython.__version__)"

If this prints a version number, installation succeeded. If you see a ModuleNotFoundError, see the errors section below.

Installation Errors

Common errors when installing wxPython with pip.

ModuleNotFoundError: No module named 'wxpython'

Cause: The package is not installed in the current Python environment.

Fix: Run pip install wxPython. If using a virtual environment, ensure it is activated first.

ModuleNotFoundError: No module named 'wxpython' (installed but still failing)

Cause: pip installed the package into a different Python than the one running your script.

Fix: Use python -m pip install wxPython to install into the interpreter you are running.

ImportError: cannot import name 'X' from 'wxpython'

Cause: The function or class does not exist in the installed version.

Fix: Check the version with pip show wxPython and upgrade with pip install --upgrade wxPython.

pip: command not found

Cause: pip is not in PATH or Python was not added to PATH during installation.

Fix: Try python -m pip install wxPython. On macOS/Linux try pip3.

PermissionError: [Errno 13] Permission denied

Cause: No write access to the system Python package directory.

Fix: Use a virtual environment, or add --user: pip install --user wxPython

SSL: CERTIFICATE_VERIFY_FAILED

Cause: pip cannot verify PyPI's SSL certificate — common behind corporate proxies.

Fix: Try: pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org wxPython

Recent Releases

Version	Released
`4.2.5` latest	2026-02-08
`4.2.4`	2025-10-29
`4.2.3`	2025-04-10
`4.2.2`	2024-09-12
`4.2.1`	2023-06-08

Full release history on PyPI →

Manage wxPython

Upgrade to latest version

pip install --upgrade wxPython

Install a specific version

pip install wxPython==4.2.5

Uninstall

pip uninstall wxPython

Check what is installed

pip show wxPython

Last updated: 2026-04-11 • Data from PyPI

How to Install wxPython in Python