+0
日增长
5,636
stars
850
forks
141
watchers
782
prs
1,972
issues
21
releases
README
pywin32 ----- This is the readme for the Python for Win32 (pywin32) extensions, which provides access to many of the Windows APIs from Python, including COM support. See CHANGES.md for recent notable changes. adodbapi's documentation can be found in: adodbapi/readme.txt isapi's documentation can be found in: isapi/README.txt Docs The docs are a long and sad story, but there's now an online version of the PyWin32.chm helpfile (thanks @ofek!). Lots of that is very old, but some is auto-generated and current. Would love help untangling the docs! You can get type hints, signatures and annotations from types-pywin32. Support Feel free to open issues for all bugs (or suspected bugs) in pywin32. pull-requests for all bugs or features are also welcome. However, please do not open GitHub issues for general support requests, or for problems or questions using the modules in this package. For pywin32 support requests, please start a discussion under the Q&A category. All non bug related issues will be converted into a discussion anyhow. The python-win32 mailing list is still available for general Python on Windows help requests. Type stubs currently live in typeshed. Any issue or request related to static type-checking and IntelliSense should be raised there. Binaries Binary releases are no longer supported. Build 306 was the last with .exe installers. You really shouldn't use them, but if you really need them, find them here Installing via PIP You should install pywin32 via pip - eg, shell python -m pip install --upgrade pywin32 There is a post-install script (see below) which should not be run inside virtual environments; it should only be run in "global" installs. For unreleased changes, you can download builds made by GitHub actions - choose any "workflow" from the main branch and download its "artifacts" Free-threaded support Building via pip with a no-GIL interpreter will create a compatible, but knowingly unsafe, wheel. This should be considered experimental; while knowingly unsafe, no wheels compatible with the free-threaded interpreter will be made available - but you can build them yourself. See NOGIL.md for the blockers to supplying these artifacts. Installing globally Outside of a virtual environment you might want to install COM objects, services, etc. You can do this by executing: shell python -m pywin32_postinstall -install or (shorter but you don't have control over which python environment is used) shell pywin32_postinstall -install If you do this with normal permissions it will be global for your user (a few files will be copied to the root of your Python install and some changes made to HKCU). If you execute this from an elevated process, it will be global for the machine (files will be copied to System32, HKLM will be changed, etc) Installing for MinGW/MSYS2 Install the package hosted by MINGW-packages (see mingw-w64-python-pywin32), from the MSYS2 shell of your environment: shell pacma
Top issues
#1289Limited support of the PyPy32 comments · 2018-12-11#1666Never use/create `win32com.gen_py`, always use one under $TEMP17 comments · 2021-02-24#1760Datetimes retrieved seem to not have their timezones set correctly16 comments · 2021-09-16#613Python Object Browser - Unable to view ActiveX CoClass16 comments · 2012-09-10#322ByRef 2D arrays of 1 Byte improperly handled16 comments · 2007-04-28#2580Pywin32 - DLL load failed while importing _win32sysloader15 comments · 2025-04-25#1143Installer should not create win32com/gen_py folder if it can't be written to by non-elevated processes15 comments · 2018-01-03#1265Adding menu items to explorer context menu fails in Windows 1014 comments · 2018-10-23
Discussions
#2758.vbs files being deprecated1 comments · 2026-05-21#2734Best practices for isolating a Windows Service entirely within a Virtual Environment (.venv)?2 comments · 2026-04-22#2709Should makepy generate subclasses for structs in the TypeLibrary?2 comments · 2026-02-14#2704Bookmarkable filters to reduce noise and help prioritize PRs2 comments · 2026-02-02#2703I want ver.3051 comments · 2026-01-27#2699WNDCLASS property read only1 comments · 2026-01-08#2685What is the type of _result in win32gui.i?2 comments · 2025-11-29#2684What's the definition of win32fileMethods?1 comments · 2025-11-28
Latest release
Build 312 b312 2026-06-04A release with a number of incremental improvements Install via pip: pip install pywin32 --upgrade More details in the README