Repository navigation
NativeHTMLKit Python SDK v0.1.0
Pre-releasenativehtmlkit (Python SDK) 0.1.0 — prerelease
nativehtmlkit is the standalone Python SDK for NativeHTMLKit Core: native HTML/CSS desktop windows driven from
Python (import nativehtmlkit), with a synchronous API and an asyncio adapter over one standard-library IPC
transport (Unix socket on Linux, named pipe on Windows). Each platform wheel embeds one prebuilt, SHA-256-pinned
Core host; no Rust toolchain, compiler or network access is needed to install or run it. The runner command is
nativehtmlkit-python (python -m nativehtmlkit); the SDK never installs a nativehtmlkit executable (that name
belongs to the Rust CLI).
Source: github.com/nativehtmlkit/nativehtmlkit-python, commit 7559b5b1f1e678017895789fabe3a1a6f59d5a74
(source-tree SHA-256 81d2171524de9fb9ba68377115cf2dca0255dd261a052e5b6c596357367ad1c7). Not published on PyPI.
Install (from the downloaded release files)
# Linux x86-64 (glibc >= 2.39, e.g. Ubuntu 24.04+, Debian 13)
python -m pip install --no-index ./nativehtmlkit-0.1.0-py3-none-manylinux_2_39_x86_64.whl
# Windows x64
python -m pip install --no-index .\nativehtmlkit-0.1.0-py3-none-win_amd64.whl
# verify: SDK/protocol versions, bundled host path, SHA-256 and manifest match
nativehtmlkit-python versionVerify downloads first with sha256sum -c SHA256SUMS (Linux) or Get-FileHash (Windows). The sdist
(nativehtmlkit-0.1.0.tar.gz) contains no host: it installs only with NATIVEHTMLKIT_DEV_SOURCE_ONLY=1 and then needs
NATIVEHTMLKIT_HOST_BINARY.
Artifacts
| File | Platform | Size | SHA-256 |
|---|---|---|---|
nativehtmlkit-0.1.0-py3-none-manylinux_2_39_x86_64.whl |
linux-x64 | 16,379,578 B | 3073066c9ad5fba8a296ba3541110e43511a2c7a4eec5669a76d2113ab59642d |
nativehtmlkit-0.1.0-py3-none-win_amd64.whl |
windows-x64 | 13,341,104 B | 183ba566d70e931c72ee28c73ae60890ede2e40d070ac26824c978bac2d867fc |
nativehtmlkit-0.1.0.tar.gz |
any | 57,784 B | 5779033930aa9af1ba5812c5da19751e71b6f3cc0e2b05aca6039aedcee31bf1 |
Also attached: SHA256SUMS, dist-manifest.json (source tree hash, Git commit, contract SHA, host SHAs). Building twice from the commit gives byte-identical files.
Embedded Core host (pinned)
| Platform | Core | Host SHA-256 | Core source |
|---|---|---|---|
| linux-x64 | 1.0.2 | 702adafcbfe3c969cb12d0de5d37546727ee13b147c8fc866c7afa18aa741d2a |
8a09875cff58aa16b60573ffca24de4d611d60b3 (clean) |
| windows-x64 | 1.0.2 | 64d4502f27782bd17329ab6d560fc27b4e3d404b719ddd9bafc507d46d8638f4 |
8a09875cff58aa16b60573ffca24de4d611d60b3 (clean) |
Wire protocol v1 (method matrix SHA-256 236aeb6deb7188bd8bd272a2e7db202336dfcb85fa4048711a73f443fd2a01a5). The bundled
host is verified against HOST-MANIFEST.json before every launch; Core licence and third-party notices ship in
nativehtmlkit/_bin/core-licenses/.
Supported
- Python 3.10, 3.11, 3.12, 3.13, 3.14 (CPython; free-threaded builds not tested).
- Linux x86-64 with glibc >= 2.39 (wheel tag
manylinux_2_39_x86_64; installers refuse older systems), KDE Plasma
Wayland qualified. Windows x64 (Windows Server 2022 interactive desktop qualified).
What was qualified (this exact source commit, these exact wheels and hosts)
Evidence: verification/2026-11-15-sdk/python/release/results.json (local, not published): 187 PASS, 0 FAIL, 4 BLOCKED,
every entry on source tree 81d21715… and the pinned hosts.
| Environment | PASS | FAIL | BLOCKED |
|---|---|---|---|
| Linux x86-64 workstation, headless real host | 38 | 0 | 0 |
| Linux KDE Plasma 6.6 Wayland desktop (Ubuntu 26.04), real windows + real input | 56 | 0 | 1 |
| Windows x64, headless real host (SSH) | 37 | 0 | 1 |
| Windows Server 2022 interactive RDP desktop, real windows + real input | 55 | 0 | 2 |
| Reproducible packaging (two builds identical) | 1 | 0 | 0 |
- Unit + fake-host suite on Python 3.10, 3.11, 3.12, 3.13, 3.14: 140 passed per interpreter on Linux, 136 on Windows
(platform-specific skips). - Offline clean install of these wheels (
--no-index, no Rust on PATH) on all five interpreters per platform, plus with
real windows on both desktops; bundled host SHA = pin; protocol 1. - Native GUI, 29 behaviour checks per desktop: window, mouse click, keyboard typing, Enter/button submit, frameless drag
and resize, native file dialog, AT-SPI / UI Automation button exposure, close veto, last-window shutdown, stale
handles, no orphan processes, a typed sentinel secret absent from diagnostics, support ZIP and host stderr. - Real-host lifecycle, async adapter, deadlines (outcome unknown), faults (host kill, malformed frame, slow/throwing
callbacks), diagnostics correlation with host records, backend output surviving every diagnostics level. - BLOCKED by design (4): the malformed-frame test on both desktops (the desktop host keeps its failure window open for
the user; it passes headless) and the POSIX-only SIGTERM test on Windows (headless and interactive). - An independent adversarial review (1 high, 6 medium, 11 low findings) preceded this release; all findings are fixed.
Known limitations
- Diagnostics
off: Core 1.0.2 relays application output through its log filter (NHK-CROSS-0007). Interim
behaviour:offdisables the SDK's own diagnostic records, but the SDK launcher runs the host atnormal, so
print()output and crash tracebacks always survive and the host's normal-level lifecycle records still appear. - Last window: closing the last window shuts the application down without a
window.eventclosedfor it
(protocol v1 behaviour); all handles become stale onapp.shutdown. - Host verification window: the bundled host is hashed before it is started; a process that can rewrite files
inside the installed package between the check and the start is out of scope. - Not tested: IME composition, DPI scaling other than 100 %, screen-reader journeys beyond element exposure
(AT-SPI / UI Automation), free-threaded CPython, runtime on glibc < 2.39 (only installer refusal is tested). - After a protocol violation or a backend crash a desktop host keeps its failure window open for the user.
- Wire protocol v1 is a release candidate (
1.0-rc), not yet declared public-stable. - Not published on PyPI; distributed only as GitHub release files.