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.