mhammond /pywin32

Python for Windows (pywin32) Extensions

★ 5,636⑂ 850👁 141⑃ 782● 1,972▤ 21
C++Created 2017-10-24
Download: Build 312b312 ↓3122026-06-04
+0
Daily
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

Discussions

Latest release

Build 312 b312 2026-06-04
A release with a number of incremental improvements

Install via pip:


pip install pywin32 --upgrade


More details in the README

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON