Install and first steps¶
NativeHTMLKit shows native desktop windows whose content is plain HTML and CSS. Your program, written in Python or PowerShell, owns the logic; a small native host process draws the window and sends you the user's events. There is no browser, no JavaScript and no local web server.
Pick your path and install¶
Choose your language. Each tab has the complete install command and a quick check that it worked. Python uses uv: each app is a
uv project, and you run its files with uv run app.py (uv provides Python 3.10 or later if needed).
Install the SDK¶
uv init --app myapp && cd myapp # a project for your app
uv add nativehtmlkit
uv run nativehtmlkit-python version # SDK, protocol and bundled host versions
Install-Module NativeHTMLKit -Scope CurrentUser
Get-NativeHTMLKitHostPath # the bundled native host for this system
Before installing, check the platform requirements and the few Linux and Windows differences.
What happens when you run an app¶
- You run your script normally (
uv run app.py,pwsh -File app.ps1). - The SDK starts the bundled native host, and the host starts your script a second time as its backend, connected over a private local channel. That is why every example keeps its work after
Application.start()/Start-NativeHTMLKitScript. See Process and lifecycle. - Your code opens windows, loads HTML, subscribes to events and announces that it is ready.
- Events (clicks, typing, form submits) arrive in your callbacks; you change the page with document commands such as "set this element's text".
- When the user closes the last window, the host shuts the application down and your script ends.
After the first window¶
- Build a complete app: the tutorials in the SDK section.
- Understand the model: Concepts.
- Look up exact APIs: Reference (each package documents its own API).
Every example on this site is a program in the repository that owns its API, run automatically against the released packages; see Examples and verification.