Skip to content

NativeHTMLKit Python SDK v0.1.0

Pre-release
Pre-release

Choose a tag to compare

@nativehtmlkit nativehtmlkit released this 15 Nov 22:11
· 23 commits to main since this release

nativehtmlkit (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 version

Verify 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: off disables the SDK's own diagnostic records, but the SDK launcher runs the host at normal, 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.event closed for it
    (protocol v1 behaviour); all handles become stale on app.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.