py2app

library0.28.10pypypiunverified

py2app is a Python setuptools command that allows you to create standalone macOS application bundles (.app) from Python scripts, including all dependencies. The current version is 0.28.10, requiring Python >=3.10. It wraps py2applet and the py2app build command, with recipes for many popular third-party packages.

devops

pip install py2app

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · PY2APP

py2app

devopspythonv0.28.10

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

py2app

✓ from py2app import py2app

✗ from py2app.command import py2app

Minimal setup.py to build a macOS .app from hello.py. Run 'python setup.py py2app' to build.

# setup.py from setuptools import setup APP = ['hello.py'] DATA_FILES = [] OPTIONS = {} setup( app=APP, data_files=DATA_FILES, options={'py2app': OPTIONS}, setup_requires=['py2app'], )

py2applet --version

Debug

Known issues

gotchainstall_requires in setup() no longer works with py2app. Use setup_requires=['py2app'] instead.

fix

Move py2app requirement from install_requires to setup_requires.

affects: >=0.28.9

breakingpy2app requires Python >=3.10 as of 0.28.10. Older versions of Python (including 2.7 and 3.9) are no longer supported.

fix

Upgrade to Python 3.10+ or pin py2app to an older version (e.g., <=0.28.8).

affects: >=0.28.10

gotchapy2app does not support free-threaded Python (3.13+ with --disable-gil).

fix

Use standard CPython without free-threading for building apps with py2app.

affects: >=0.28.9

deprecatedpkg_resources usage is deprecated; fallback only for ancient Python versions.

fix

Ensure your application does not rely on pkg_resources; modern setuptools uses importlib.resources.

affects: >=0.28.9

Upgrade

Version history

0.28.10latest on PyPI · released Feb 13, 2026

Audit

Dependencies

setuptoolsrequiredpy2app extends setuptools commands; compatibility issues with setuptools >=82 existed in earlier versions.

Agent activity

6 hits · last 30 days

node

Resources

githubhttp://github.com/ronaldoussoren/py2app ↗

packagehttps://pypi.org/project/py2app/ ↗

homepagehttps://py2app.readthedocs.io ↗

docshttps://py2app.readthedocs.io/en/latest/ ↗