Repository navigation
NativeHTMLKit Python SDK v0.1.1
nativehtmlkit (Python SDK) 0.1.1
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 at runtime. The runner command is
nativehtmlkit-python (python -m nativehtmlkit); the SDK never installs a nativehtmlkit executable (that
name belongs to the Rust CLI).
This is a full release. It bundles NativeHTMLKit Core 1.0.3, whose wire protocol v1 is the stable wire
contract (1.0).
Source: github.com/nativehtmlkit/nativehtmlkit-python, commit f0b92903b79fbae4d8c292c6a5c8988b99391139
(source-tree SHA-256 24a32224a78ba19107bc78716fb350236f32437331893c1b0211f7512ff6b535).
Install
python -m pip install nativehtmlkit==0.1.1 # from PyPI (the two platform wheels below)
nativehtmlkit-python version # bundled host, its SHA-256, manifest and source identity matchOr from the downloaded release files (verify with sha256sum -c SHA256SUMS / Get-FileHash first):
python -m pip install --no-index ./nativehtmlkit-0.1.1-py3-none-manylinux_2_39_x86_64.whl # Linux x86-64
python -m pip install --no-index .\nativehtmlkit-0.1.1-py3-none-win_amd64.whl # Windows x64Supported: CPython 3.10, 3.11, 3.12, 3.13, 3.14 on Linux x86-64 with glibc ≥ 2.39 (wheel tag
manylinux_2_39_x86_64; e.g. Ubuntu 24.04+, Debian 13) and Windows x64 (Windows 10/11, Server 2022). On any other
platform pip finds no compatible distribution and reports that no matching distribution was found: there is no
source distribution on PyPI. The sdist attached to the GitHub Release contains no host and builds only with
NATIVEHTMLKIT_DEV_SOURCE_ONLY=1 (then set NATIVEHTMLKIT_HOST_BINARY).
Changes since 0.1.0 (prerelease)
- Bundles Core 1.0.3 (protocol v1 stable). Diagnostics level
offnow reaches the host unchanged: Core 1.0.3 relays
application output and tracebacks at every level (NHK-CROSS-0007 fixed), so the 0.1.0 interim off→normal mapping
is gone. - Responses are correlated strictly by request id; Core 1.0.3 may answer a
document.loadfrom a file after later
requests (tested sync and asyncio, and on both real hosts). Application.host_diagnostics(); the host'sdropped_notificationscounter is recorded at shutdown and exposed
asApplication.host_dropped_notifications(the SDK's reader never runs application code, so it stays 0).- Each wheel records the host's
--version --verbosesource identity, cross-checked against the Core release
manifest at packaging and bynativehtmlkit-python versionon the target. - Core 1.0.3 behaviour documented: windows first shown when their first document loads (≤ 750 ms), clamped to the
work area; Windows bitmap transport files in%TEMP%\nativehtmlkit-bitmaps\. - PyPI metadata (classifiers, project URLs, licence files) and README install section.
Artifacts
| File | Platform | Size | SHA-256 |
|---|---|---|---|
nativehtmlkit-0.1.1-py3-none-manylinux_2_39_x86_64.whl |
linux-x64 | 16,405,831 B | 5478384b9a10a130166e3d8877b25b13c7d5004a23165e0aa62aa686e7acffe4 |
nativehtmlkit-0.1.1-py3-none-win_amd64.whl |
windows-x64 | 13,364,530 B | 5ac1a1ef67b2f88e3f59630e01f0da8149dd4e4aa6b2fcfc05e8d4e77900cdd5 |
nativehtmlkit-0.1.1.tar.gz |
any | 66,636 B | 143aecc65cd56373ac7619d9bf8a4207ed5f91ba677409b873641dff29777db2 |
Also attached: SHA256SUMS (lists both wheels by file name), dist-manifest.json. Building twice from the commit gives byte-identical files; all three pass twine check --strict. PyPI receives only the two wheels.
Embedded Core host (pinned)
| Platform | Core | Host SHA-256 | Core commit |
|---|---|---|---|
| linux-x64 | 1.0.3 | 1cd4e9de701f3ef8d8b870b678765243f2365d69d7352c0543f171ff249c999f |
d73dec36adbe1b1380f982388d13655750e607df (clean) |
| windows-x64 | 1.0.3 | 15967208d2e20d208d69b97bba6f397056e28c57add126909a8734361ae8f8c8 |
d73dec36adbe1b1380f982388d13655750e607df (clean) |
Wire protocol v1 (stable, 1.0; method matrix SHA-256 236aeb6deb7188bd8bd272a2e7db202336dfcb85fa4048711a73f443fd2a01a5).
The bundled host is verified against HOST-MANIFEST.json before every launch.
What was qualified (this commit, these exact wheels and hosts)
Evidence (local): verification/2026-11-16-full-release/python/release/results.json — 187 PASS, 0 FAIL,
4 BLOCKED, every entry on source tree 24a32224a78b… and the pinned Core 1.0.3 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 | 37 | 0 | 1 |
| Windows Server 2022 interactive RDP desktop, real windows + real input | 55 | 0 | 2 |
Reproducible packaging + twine check --strict |
1 | 0 | 0 |
- Unit + fake-host suite on CPython 3.10, 3.11, 3.12, 3.13, 3.14: 146 passed per interpreter on Linux, 141 on
Windows (platform-specific skips). - Offline clean install of these exact wheels (
--no-index, no Rust on PATH) on all five interpreters per platform,
plus with real windows on both desktops: bundled host SHA = pin, host source identity = manifest, protocol 1. - Native GUI, 29 behaviour checks per desktop: window, mouse, keyboard typing, Enter/button submit, frameless drag
and resize, native file dialog, AT-SPI / UI Automation exposure, close veto, last-window shutdown, stale handles,
no orphans, a typed sentinel secret absent from diagnostics, support ZIP and host stderr. - Real host: lifecycle, asyncio adapter, deadlines (outcome unknown), out-of-order
document.loadreplies, faults
(host kill, malformed frame, slow/throwing callbacks), backend output at every diagnostics level includingoff,
bitmap budget/leak checks, hostdropped_notifications= 0, session correlation with host records. - 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).
Known limitations
- Licence metadata: the package metadata says
MIT, which covers the SDK's own code. Each wheel also contains
the Core host binary (MIT) and its third-party content under their own licences (OFL-1.1 font, MPL-2.0
components, CC-BY-4.0 stylesheets, many crate licences); the full texts ship innativehtmlkit/_bin/core-licenses/. - Host verification window: the bundled host is hashed before it is started; a process able to rewrite files
inside the installed package between check and start is out of scope. - Events can be lost if callbacks block: the SDK queues up to 128 application events while a callback runs;
beyond that it drops and counts them (rpc.dropped_notifications). Keep event callbacks short. - Last window: closing it shuts down without a
window.eventclosed(protocol v1 behaviour); all handles are
stale afterapp.shutdown. - After a protocol violation or backend crash a desktop host keeps its failure window open for the user.
- Not qualified: IME composition, DPI scaling other than 100 % and mixed per-monitor scale on Windows,
screen-reader journeys beyond element exposure (AT-SPI / UI Automation), real suspend/resume, free-threaded
CPython, runtime on glibc < 2.39 (installer refusal only), and no cross-SDK parity suite (Python vs PowerShell vs
CLI behaviour is tested per SDK, not side by side).