Skip to main content

NativeHTMLKit for Python

Native desktop windows from ordinary Python and local HTML/CSS. The Rust Core host draws the interface; Python handles application logic and events. No browser, JavaScript, HTTP server, or Node.js runtime is required.

PyPI package · Public developer guide · API reference · Examples

Illustrative NativeHTMLKit application gallery, not an actual captured desktop screenshot

Illustration only — not a verified screenshot. Run the real gallery demo to inspect the actual application. The illustration will be replaced after interactive desktop verification.

Install

python -m pip install nativehtmlkit
# or: uv add nativehtmlkit
nativehtmlkit-python version

Published wheels target Windows x64 and Linux x64 (the currently released Linux wheel specifies glibc 2.39+). Check platform compatibility before assuming a pip install will work. The source distribution does not bundle the native host; use a compatible published wheel for normal use. Python 3.10+.

Your first app

Save as hello.py:

from nativehtmlkit import Application

def main():
    with Application.start(name="Hello NativeHTMLKit") as app:
        window = app.open_html('''<main style="padding:24px;font-family:sans-serif">
<h1>Hello from Python</h1><button id="hello">Click me</button><p id="status">Ready</p>
</main>''')
        window.document.on("click", lambda event:
            window.document.set_text("status", "Clicked!"), element="hello")
        app.run()

if __name__ == "__main__":
    main()

Run python hello.py or uv run hello.py. Application.start() launches a supervised host and re-executes the backend: keep side effects inside main(). Alternatively python -m nativehtmlkit run module:main runs a main(app) backend entrypoint once.

What you can build

  • Multiple windows, native file/folder dialogs and application lifecycle policies.
  • HTML/CSS documents, event callbacks, DOM updates, forms and selection.
  • Clipboard, desktop preferences, diagnostics, bounded live-bitmap surfaces.
  • Asyncio callbacks and completion futures over the same local host connection.

For layouts, reactive state and reusable controls, use the separate Python UI library rather than inventing new SDK surface.

Learn more

Guide Purpose
API reference Real public Python objects, methods and error handling
Architecture Lifecycle, host, IPC and threading
Examples Next steps and the interactive demo gallery
Build and testing Release source, wheels and qualification
Public tutorials Screenshots, learning path and capability matrix
Skill Agent instructions to build a Python app

Package version: 0.1.2 (bundles NativeHTMLKit Core 1.0.3, public wire protocol v1). 0.1.2 refreshes documentation and the bundled agent skill; the SDK API is unchanged from 0.1.1.

Project navigation

Metadata

Release files for nativehtmlkit 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for nativehtmlkit 0.1.2
File Interpreter ABI Platform Actions
nativehtmlkit-0.1.2-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for nativehtmlkit-0.1.2-py3-none-win_amd64.whl
nativehtmlkit-0.1.2-py3-none-manylinux_2_39_x86_64.whl Python 3 none Linux glibc 2.39+ x86-64 Details for nativehtmlkit-0.1.2-py3-none-manylinux_2_39_x86_64.whl

Total release size: 29.8 MB

Release files / nativehtmlkit-0.1.2-py3-none-win_amd64.whl

Download URL nativehtmlkit-0.1.2-py3-none-win_amd64.whl
Size 13.4 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
2db2039aedc6db93a793ae5fef2b19d1b17560b934dd405f411bf73bd051afce
BLAKE2b-256 checksum
How to use checksums
8f096e7911b210e3c856a0b6dde27a5628c9406fe319755fb2e03e6ddca43ec8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / nativehtmlkit-0.1.2-py3-none-manylinux_2_39_x86_64.whl

Download URL nativehtmlkit-0.1.2-py3-none-manylinux_2_39_x86_64.whl
Size 16.4 MB
Tags Linux glibc 2.39+ x86-64 Python 3
SHA-256 checksum
How to use checksums
ebf7eec230f6664976c1ca717553034390add6d652ae7c15d78cb4b9cb63c4f2
BLAKE2b-256 checksum
How to use checksums
74cd6340b803b6ff2c772fe0b8de9b36a445478a085a37a2b5c331520773f68f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Security for nativehtmlkit 0.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for nativehtmlkit-0.1.2-py3-none-win_amd64.whl

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.2 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page