Skip to content

Platform requirements

The released packages documented here are Core 1.0.3, Python SDK 0.1.2 and PowerShell SDK 0.1.2. Each SDK package bundles the matching Core host, so you never install Core separately.

Desktops

Desktop Status
Linux, KDE Plasma on Wayland Target desktop for both SDKs
Windows (x64), interactive desktop session Target desktop for both SDKs
Other Linux desktops, macOS Not targeted by these releases

A window needs an interactive desktop session. A plain SSH session, a service account or a CI runner can still run apps in the host's headless test mode (NATIVEHTMLKIT_TEST_MODE=1): the whole protocol runs without a window, but there is no user input, no clipboard and no native file dialog. See Troubleshooting (PowerShell).

Runtimes

Entry point Linux Windows
Python SDK nativehtmlkit Python 3.10+; x64 wheel tagged manylinux_2_39_x86_64 (glibc 2.39 or newer) Python 3.10+; x64 wheel
PowerShell SDK NativeHTMLKit PowerShell 7.2+ PowerShell 7.2+ and Windows PowerShell 5.1

If uv cannot find a compatible wheel on Linux, your distribution's glibc is probably older than 2.39. Do not fall back to the source distribution and expect a window: it contains no native host.

Check an installation

uv run nativehtmlkit-python doctor      # Python (in your uv project): the host's environment report
uv run nativehtmlkit-python version     # Python: SDK, protocol and bundled host versions as JSON
Get-Module NativeHTMLKit -ListAvailable | Select-Object Name, Version
Get-NativeHTMLKitHostPath        # the bundled host for this platform

For per-feature availability see the capability matrix and the limitations.