Skip to main content

PyWinGUI Private Build Repository

This repository contains the private PyWinGUI implementation and release pipeline. It is not the public customer repository.

PyWinGUI is a proprietary Windows GUI automation SDK backed by a protected native runtime. The public repository exposes the Python API surface, while the automation engine, control matching, OCR, AI recovery, orchestration, and licensing logic remain private.

Repository Roles

Private repository:

  • Owns the real implementation under pywingui/.
  • Owns licensing under pywingui/licensing/.
  • Builds the protected native runtime with Nuitka.
  • Generates the clean public repository.
  • Builds and verifies the PyPI wheel.

Public repository:

  • Contains public Python wrappers and type/API surface.
  • Contains tests proving the public source boundary.
  • Contains one protected native runtime file under pywingui/native/.
  • Does not contain pywingui/licensing/.
  • Does not contain private runtime Python source.

Protected Runtime

The private runtime is compiled into:

dist/runtime_pyd/pywingui_native_runtime.cp313-win_amd64.pyd

The public wheel includes that file at:

pywingui/native/pywingui_native_runtime.cp313-win_amd64.pyd

The public SDK loads the runtime through pywingui.bridge.RuntimeClient. Customers call normal PyWinGUI APIs; private logic stays inside the compiled runtime.

One-Command Local Release

Run:

release_public.bat

The BAT already uses:

--jobs 48

Release stages:

  1. Run private/runtime tests.
  2. Compile the protected .pyd with Nuitka.
  3. Assemble the clean public repository.
  4. Run public SDK tests.
  5. Build the platform wheel.
  6. Install the wheel in a clean environment.
  7. Load the native runtime and run runtime.selftest.

Expected wheel:

dist/public_wheels/pywingui-<version>-cp313-cp313-win_amd64.whl

Publish To PyPI

Set the PyPI token first:

set TWINE_PASSWORD=pypi-your-token

Then run:

release_public.bat --publish-pypi

Publishing only happens after tests, compile, wheel build, and clean-install verification pass.

Push Public Repository

To create/update the public repo locally and push it:

release_public.bat --commit --push --remote https://github.com/YOUR_ACCOUNT/pywingui.git

To push Git and publish PyPI in one run:

set TWINE_PASSWORD=pypi-your-token
release_public.bat --commit --push --publish-pypi --remote https://github.com/YOUR_ACCOUNT/pywingui.git

The generated public repo path is:

C:\projects\pywingui-public

Manual Commands

Run all private/runtime tests:

python -m pytest pywingui/tests tests/runtime -q

Build only the native runtime:

python scripts\build_runtime_pyd.py --clean --skip-tests --jobs 48

Assemble public repo and wheel:

python scripts\assemble_public_release.py

Verify a wheel in a clean environment:

python scripts\verify_public_wheel.py dist\public_wheels\pywingui-<version>-cp313-cp313-win_amd64.whl

Public Boundary Rules

Do not put these in the public repository:

  • pywingui/licensing/
  • Private runtime Python source
  • API keys, tokens, backend URLs, or license secrets
  • Internal OCR provider implementations
  • Core matching, orchestration, recovery, and automation engine logic

The public wheel must contain exactly one native runtime .pyd and no private runtime .py files.

License

PyWinGUI is proprietary software. All implementation rights, protected runtime rights, licensing logic, automation logic, OCR logic, AI recovery logic, and related trade secrets remain owned by PyWinGUI Engineering.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pywingui-6.1.58-cp313-cp313-win_amd64.whl (672.2 kB view details)

Uploaded CPython 3.13Windows x86-64

File details

Details for the file pywingui-6.1.58-cp313-cp313-win_amd64.whl.

File metadata

  • Download URL: pywingui-6.1.58-cp313-cp313-win_amd64.whl
  • Upload date:
  • Size: 672.2 kB
  • Tags: CPython 3.13, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.14

File hashes

Hashes for pywingui-6.1.58-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 497d6b5af97b0eb2f515e844ef697525ad54b6c6c71290c3e11956091de599ac
MD5 b33754a2bcf525aad467532794bba1af
BLAKE2b-256 8a96014d9bf434a27843b23963d4e789b5d8c4dc260436f92f3fcfc23f3fe1ed

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page