Skip to content

Releases

NativeHTMLKit Python SDK v0.1.2

Choose a tag to compare

@nativehtmlkit nativehtmlkit released this 16 Nov 05:47

nativehtmlkit (Python SDK) 0.1.2

Documentation and marketplace-description release. The SDK API and behaviour are unchanged from 0.1.1. Each platform wheel bundles the same NativeHTMLKit Core 1.0.3 host as 0.1.1 (public stable wire protocol v1), with the same SHA-256s:
Linux 1cd4e9de701f3ef8d8b870b678765243f2365d69d7352c0543f171ff249c999f, Windows 15967208d2e20d208d69b97bba6f397056e28c57add126909a8734361ae8f8c8.

Source: commit 05227394f80dd97a2b6f5ff98db59cac3669d9ec (source-tree SHA-256 e8695ce8b9f4e5456bb2dfc1f7053ca15c92528d5409966a3e814d5f4a1534df).

Changes since 0.1.1

  • New PyPI project description (README) with absolute links that work on PyPI.
  • The bundled agent skill (nativehtmlkit/_skills/nativehtmlkit-python) now matches the revised skills/nativehtmlkit-python source, including references/examples.md.
  • Version strings: nativehtmlkit.__version__ and the client version are 0.1.2.

Install

python -m pip install nativehtmlkit==0.1.2
nativehtmlkit-python version

Supported: CPython 3.10–3.14 on Linux x86-64 with glibc ≥ 2.39 (manylinux_2_39_x86_64) and Windows x64. The sdist attached here contains no host and is not uploaded to PyPI.

Qualification of these exact files (local lab, not CI)

Environment PASS FAIL BLOCKED
Linux workstation headless (unit on 3.10 and 3.14, contract, real-host integration, packaging, clean offline install) + linuxDEV KDE Plasma 6.6 Wayland (real-window integration, installed wheel, native GUI driver) 89 0 1
winDEV Windows Server 2022: admin SSH headless + interactive RDP desktop (real windows, installed wheel, native GUI driver) 87 0 3

BLOCKED checks match 0.1.1: the malformed-frame test can't run unattended in desktop mode (the host keeps its failure window open; covered headless), and the SIGTERM relay test is POSIX-only (Windows uses the job object). twine check passed for every distribution.

NativeHTMLKit Python SDK v0.1.1

Choose a tag to compare

@nativehtmlkit nativehtmlkit released this 16 Nov 01:52

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).

NativeHTMLKit Python SDK v0.1.0

Pre-release

Choose a tag to compare

@nativehtmlkit nativehtmlkit released this 15 Nov 22:11

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.