# Install wxpython with Homebrew

Python bindings for wxWidgets. Version 4.2.5 via Homebrew; verified 2026-06-22.

## Install

```sh
sudo av install brew:wxpython
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install wxpython
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:wxpython
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/wxpython>
- **Version:** 4.2.5
- **Source summary:** Python bindings for wxWidgets
- **Homepage:** <https://www.wxpython.org/>
- **Repository:** <https://github.com/wxWidgets/Phoenix>
- **Upstream docs:** <https://docs.wxpython.org/>
- **License:** LGPL-2.0-or-later WITH WxWindows-exception-3.1
- **Source archive:** <https://files.pythonhosted.org/packages/22/43/81657a6b126ffc19163500a8184d683cec08eb4e1d06905cd0c371c702d0/wxpython-4.2.5.tar.gz>
- **Last updated:** 2026-06-22T14:06:40-07:00
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- helpviewer (cli)
- img2png (cli)
- img2py (cli)
- img2xpm (cli)
- pycrust (cli)
- pyshell (cli)
- pyslices (cli)
- pyslicesshell (cli)
- pywxrc (cli)
- wxdemo (cli)
- wxdocs (cli)
- wxget (cli)
- helpviewer (alias)
- img2png (alias)
- img2py (alias)
- img2xpm (alias)
- pycrust (alias)
- pyshell (alias)
- pyslices (alias)
- pyslicesshell (alias)
- pywxrc (alias)
- wxdemo (alias)
- wxdocs (alias)
- wxget (alias)

## Dependencies

- numpy
- pillow
- python@3.14
- wxwidgets@3.2

## Build dependencies

- cython
- doxygen
- python-setuptools
- sip

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 4.2.5
- Package-manager updated: 2026-06-22
- Local data: ok
- Upstream repository: https://www.wxpython.org/
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

wxPython is the Python binding for wxWidgets, giving Python applications native GUI widgets on Windows, macOS, Linux, and other Unix-like systems. Its history spans hand-written bindings in the 1990s, SWIG-generated Classic wxPython, and the Phoenix rewrite used by modern wxPython 4.x.

### Project history

The official history says wxPython began in 1996, after Robin Dunn discovered Python bindings while evaluating cross-platform GUI toolkits. Dunn worked with Harri Pasanen, with help from Edward Zimmerman, to advance early wxWidgets bindings into wxPython 0.2.

The first versions were maintained by hand, which became fragile as the codebase grew. In 1997 Dunn used SWIG to reimplement the bindings, and in summer 1998 the first modern wxPython release appeared for wxWidgets 2.0. The changelog still goes back to release 0.3 in 1998.

Project Phoenix later replaced Classic wxPython with a from-the-ground-up implementation focused on speed, maintainability, extensibility, Python 3 compatibility, and removing accumulated cruft. The official overview notes that Phoenix is intentionally not fully backwards compatible, though many applications can migrate with minor changes.

### Adoption history

wxPython became one of Python's major desktop GUI choices alongside Tkinter, PyQt/PySide, and later web-driven app shells. Its appeal was always native widgets with little platform-specific code, backed by wxWidgets rather than an emulated toolkit.

The Phoenix transition was also an adoption transition: users had to move old Classic code to Python 3-era APIs. The official docs still foreground the Migration Guide for programmers porting from Classic wxPython to Phoenix.

### How it is used

Developers import wx, create a wx.App, instantiate frames and controls, bind events, and run MainLoop. The package also includes demo, shell, resource, image-conversion, documentation, and inspection-oriented tools that make it useful as a full GUI development environment rather than just a runtime binding.

In packaging, wxPython is notable because it wraps a large C++ GUI toolkit and ships platform-specific wheels or builds tied to wxWidgets versions. The changelog records ongoing work to keep pace with Python, wxWidgets, operating-system, and build-tool changes.

### Why package nerds care

wxPython is package-nerd significant because it is a classic binding package: a large native-code bridge that lets a high-level language use a mature C++ toolkit. Its Classic-to-Phoenix migration is a textbook example of how language runtimes, binding generators, binary wheels, and GUI frameworks force long-lived packages to reinvent themselves.

### Timeline

- 1995: Robin Dunn discovered wxWidgets and Python while looking for a cross-platform C++ GUI toolkit.
- 1996: Official history dates the start of wxPython history to before the turn of the century, back in 1996.
- 1997: SWIG was adopted to reduce the maintenance burden of hand-written bindings.
- 1998: The first modern wxPython release appeared in summer 1998; the changelog goes back to 0.3.
- 2010s: Project Phoenix rebuilt wxPython for maintainability and Python 3.
- 2025-04-09: wxPython 4.2.3 released, built on wxWidgets 3.2.7.
- 2026-02-08: wxPython 4.2.5 released, built on wxWidgets 3.2.9.

### Related projects

- wxPython is related to wxWidgets, Project Phoenix, Classic wxPython, SWIG, Tkinter, PyQt/PySide, wxGlade, wxFormBuilder, and Python desktop GUI applications.

### Sources

- <https://docs.wxpython.org/MigrationGuide.html>
- <https://github.com/wxWidgets/Phoenix>
- <https://wiki.wxpython.org/RobinDunn>
- <https://wxpython.org/pages/changes/index.html>
- <https://wxpython.org/pages/history/>
- <https://wxpython.org/pages/overview/index.html>


## Security Notes

broad file, network, media, or database tool signal. generalized runtime or code generation signal.

- **Geiger risk:** yellow / medium
- broad file, network, media, or database tool signal
- generalized runtime or code generation signal

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** wxpython
- **Version Scheme:** 0
- **Revision:** 1
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## Related links

- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [numpy](https://www.automicvault.com/pkg/brew/numpy/) - Runtime dependency declared by Homebrew.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [wxwidgets@3.2](https://www.automicvault.com/pkg/brew/wxwidgets-3-2/) - Runtime dependency declared by Homebrew.
- [cython](https://www.automicvault.com/pkg/brew/cython/) - Build dependency declared by Homebrew.
- [doxygen](https://www.automicvault.com/pkg/brew/doxygen/) - Build dependency declared by Homebrew.
- [sip](https://www.automicvault.com/pkg/brew/sip/) - Build dependency declared by Homebrew.
- [wxlua](https://www.automicvault.com/pkg/brew/wxlua/) - Shares av.db curated category or tags: cli, cross-platform, developer-tools, gui, gui-toolkit.
- [wxwidgets](https://www.automicvault.com/pkg/brew/wxwidgets/) - Shares av.db curated category or tags: cli, cross-platform, developer-tools, gui, gui-toolkit.
- [pybind11](https://www.automicvault.com/pkg/brew/pybind11/) - Shares av.db curated category or tags: cli, developer-tools, language-bindings, python.
- [gi-docgen](https://www.automicvault.com/pkg/brew/gi-docgen/) - Shares av.db curated category or tags: api-reference, cli, developer-tools, python.
- [git-cola](https://www.automicvault.com/pkg/brew/git-cola/) - Shares av.db curated category or tags: cli, developer-tools, gui.
- [git-gui](https://www.automicvault.com/pkg/brew/git-gui/) - Shares av.db curated category or tags: cli, developer-tools, gui.
- [neovide](https://www.automicvault.com/pkg/brew/neovide/) - Shares av.db curated category or tags: cli, developer-tools, gui.

## Combined YAML source

View the package source record on GitHub. [combined/wxpython.yml](https://github.com/automic-vault/db/blob/main/combined/wxpython.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
