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
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
- Overview and tutorials — public developer landing page.
- Capability and platform matrix — which API works where.
- Known limitations — known defects and qualification limits.
- Active private development work is tracked in
nativehtmlkit-project, not in this repository's documentation.
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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.