Skip to main content

GUI toolkit for building GUI toolkits (and create beautiful applications for mobile, web, and desktop from a single python3 codebase)

Project description

HTag : "H(tml)Tag"


Package version

A new python library to create UI (or UI toolkit), which render nativly in anything which can render html/js/css. Thoses can be a browser, a pywebview, an android/apk, or anything based on cef, depending on an htag runner ! As it's based on html/js rendering: you can easily mix powerful JS libs with powerful PY3 libs : and make powerful python apps !

  • For a desktop app :
    • You can use the Runner, which will run the UI in a local chrome in "app mode" (headless).
    • You can use the PyWebView runner, which will run the UI in a pywebview container
  • For a android app : See htagapk
  • For a web app : You can use the htagweb.
  • For a html app (think SPA (run in an html context (no python!))):

But yes … the promise is here : it's a GUI toolkit for building "beautiful" applications for mobile, web, and desktop from a single codebase.




Available on

Announcement on reddit (22/07/14)

Well tested:

To have a look

  • A htag app, hosted on, running with htagweb. Many examples from simpler to complex ones, in tutorial spirit.
  • pyscript/demo: A htag app in a simple html page, running with pyscript runner. Many examples in a REPL mode (you can try/edit/run them). (ONLY HTML needed)

ROADMAP to 1.0.0

  • tests tests
  • the "0.100.x" version introduce a "new event mechanism" ("ev") : need to find a solution if it will be mandatory for 1.0.0 (don't know yet), to not break my (more than) 200 apps ;-) ... currently both are available (depending of the parameter name)
  • the "0.90.x" version is important, because all previous runners (using starlette/uvicorn/tornado) are gone, and are simulated/faked with a new Runner ! So compatibility shouldn't be breaked with htag <0.90 ! But they will be removed in 1.0.
  • polish the new Runner Runner and docs !
  • setup minimal docs, with that ;-)
  • top level api could change (Tag() -> create a Tag, Tag.mytag() -> create a TagBase ... can be a little bit ambiguous)
  • manage "query params" from url to initialize Tags/routes
  • I don't really like the current way to generate js in interaction : need to found something more solid.
  • the current way to initiate the statics is odd (only on real (embedded) Tag's) : should find a better way (static like gtag ?!)

and more technicals :

  • ~~better js try/catch to sort js/py error + try/catch on http com error (for thoses which kill session webhttp/pye) ~~

  • getStateImage is non sense coz it's str'ing (why not returning the str ?!)

  • mix the Tag.init with the old system (like this: it's unmaintable)

  • introduce a virtual tag/placeholder

  • DISPLAY a warning (or exception in STRICT_MODE), when a render method use a "tag creation" (ex: Tag.div("hello")), because it will always be rendered !!!!! -> bad habits

  • rename "tag" to "self" for js statements (keep the twos, for compatibility reasons)

  • Make it possibles -> NOT POSSIBLE currently ... abandonned ;-) self.js = self.bind( self.starting , b'window.innerWidth') # doesn't work currently self.js = self.bind.starting( b'window.innerWidth' ) # work (only reason to keep the "old form")

  • perhaps self( js_statement) -> js_statement ) ... less confusing !

  • thus, to avoid self( self.bind.method(*a,**k) ), you can write<method>( *a,**k )


At the beginning, there was guy, which was/is the same concept as python-eel, but more advanced. One day, I've discovered remi, and asked my self, if it could be done in a guy way. The POC was very good, so I released a version of it, named gtag. It worked well despite some drawbacks, but was too difficult to maintain. So I decided to rewrite all from scratch, while staying away from guy (to separate, rendering and runners)... and htag was born. The codebase is very short, concepts are better implemented, and it's very easy to maintain.

Project details

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

htag-0.111.2.tar.gz (34.2 kB view hashes)

Uploaded Source

Built Distribution

htag-0.111.2-py3-none-any.whl (37.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page