Skip to content

NativeHTMLKit Python SDK v0.1.1

Choose a tag to compare

@nativehtmlkit nativehtmlkit released this 16 Nov 01:52
· 20 commits to main since this release

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 match

Or 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 x64

Supported: 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 off now 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.load from a file after later
    requests (tested sync and asyncio, and on both real hosts).
  • Application.host_diagnostics(); the host's dropped_notifications counter is recorded at shutdown and exposed
    as Application.host_dropped_notifications (the SDK's reader never runs application code, so it stays 0).
  • Each wheel records the host's --version --verbose source identity, cross-checked against the Core release
    manifest at packaging and by nativehtmlkit-python version on 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.load replies, faults
    (host kill, malformed frame, slow/throwing callbacks), backend output at every diagnostics level including off,
    bitmap budget/leak checks, host dropped_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 in nativehtmlkit/_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.event closed (protocol v1 behaviour); all handles are
    stale after app.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).