What is PUI

PUI is a reactive/declarative UI framework with two-way data binding. PUI doesn't do UI itself, it turns imperative UI libraries into reactive/declarative flavor with virtual DOM and aims to maintain interoperability.

Slides for SciWork 2023

CPPUI: Experimental C++ Version

Features

Declarative UI
Reactive state with two-way binding
Hot Reloading
Multiple Backends

Installation

pip install QPUIQ

# Optional, for hot-reload
pip install jurigged

# Optional, for PySide6 backend
pip install PySide6

# Optional, for textual backend
pip install textual

# Optional, for wxPython backend
pip install wxPython

# Optional, for flet backend
pip install flet

Get Started

Hello World

# example/hello_world.py
from PUI.PySide6 import *

@PUIApp
def Example():
    with Window(title="test", size=(320,240)):
        Label("Hello world")

root = Example()
root.run()

Hello World

State & Data Binding

# example/generic_textfield.py
from PUI.PySide6 import *

data = State()
class Example(Application):
    def __init__(self):
        super().__init__()
        data.var = 0

    def content(self):
        with Window(title="blah"):
            with VBox():
                with HBox():
                    Button("-").click(self.on_minus)
                    Label(f"{data.var}")
                    Button("+").click(self.on_plus)

                TextField(data("var")) # binding

    def on_minus(self):
        data.var -= 1

    def on_plus(self):
        data.var += 1

root = Example()
root.run()

State & Data Binding

View Component

# example/bleak_list.py

....

@PUI # View Component
def DeviceView(device, advertising_data):
    Label(f"{device.address} {device.name} {advertising_data.rssi}")

class GUI(Application):
    def __init__(self, state):
        super().__init__()
        self.state = state

    def content(self):
        with Window(title="BLE List"):
            with VBox():
                Label(f"Found {len(self.state.scanned_devices)} devices")
                for device, advertising_data in self.state.scanned_devices:
                    DeviceView(device, advertising_data)

....

View Component

Layout & Styling

# example/pyside6_feedparser.py

...
with VBox():
    Label(title).qt(StyleSheet={"font-weight":"bold"}) # QT-specific

    with HBox():
        with Scroll():
            with VBox():
                for i,e in enumerate(entries):
                    Label(e.title).click(self.entry_selected, i)
                Spacer()

        with Scroll().layout(weight=1): # Generic Layout Parameter
            if 0 <= selected and selected < len(entries):
                (Text(entries[selected].description)
                    .layout(padding=10) # Generic Layout Parameter
                    .qt(StyleSheet={"background-color":"white", "color":"black"})) # QT-specific
...

Layout & Styling

Canvas

# example/generic_canvas.py

from PUI.PySide6 import *

data = State()
class Example(Application):
    def __init__(self):
        super().__init__()
        data.var = 50

    def content(self):
        with Window(title="blah", size=(640,480)):
            with VBox():
                Canvas(self.painter, data.var)
                with HBox():
                    Button("-").click(self.on_minus)
                    Label(f"{data.var}").layout(weight=1)
                    Button("+").click(self.on_plus)

    @staticmethod
    def painter(canvas, var):
        # Canvas coordinates are logical pixels. Use pixel_density when
        # preparing raster images for HiDPI displays.
        raster_scale = canvas.pixel_density
        canvas.drawText(var, var/2, f"blah {var}")
        canvas.drawLine(var, var, var*2, var*3, color=0xFFFF00)

    def on_minus(self):
        data.var -= 1

    def on_plus(self):
        data.var += 1

root = Example()
root.run()

canvas.pixel_density is the number of physical display pixels per logical canvas pixel. It is updated before each paint where the backend exposes the display scale, so moving a window between displays is handled automatically. Canvas coordinates remain in logical pixels; multiply raster image resolution by pixel_density when generating HiDPI content. Backends that cannot report a display scale use 1.0.

Canvas

Cookbook

python -m cookbook PySide6 (requires pygments for syntax highlight)

Cookbook 1 Cookbook 2

python -m cookbook textual

python -m cookbook flet

python -m cookbook tkinter

Hot Reload

pip install jurigged

Then PUI will take care of view update (code)

Backends

Tier-1

PySide6

Lower Priority

wx
tkinter
- or https://github.com/rdbende/Sun-Valley-ttk-theme
flet
textual (Text Mode)
- no canvas

Documents

Used by

TODO

Dump with layout parameters and add test cases
Toga
[ISSUE] flet layout sizing (cookbook scroll example)
nested state trigger
- set state in PUIView init
- set state in setup() ?
Tabs(tabposition)
Lazy List
UI Flow
- Navigation Stack
- View Router
- Model Window/Dialog
Layout
- SwiftUI style overlay ??
Canvas
- Arc
- ...
State with Pydantic support?

Release files for qpuiq 0.48

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

Source distribution (sdist)

Source distribution for qpuiq 0.48
File	Size	Uploaded
qpuiq-0.48.tar.gz	52.4 kB	Sep 24, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for qpuiq 0.48
File	Interpreter	ABI	Platform	Reset
qpuiq-0.48-py3-none-any.whl 78.7 kB Sep 24, 2026	Python 3	none	any	Details

Total release size: 131.0 kB

Release files / qpuiq-0.48.tar.gz

Download URL	qpuiq-0.48.tar.gz
Size	52.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`1225a3922146cd2b67dbb599842fd660d62a1eb2a5a6e03ed6c71ab570d26c5d`
BLAKE2b-256 checksum How to use checksums	`a58240f6a90a47084d821d985daa568d9f7b76c4868cfd7bc37f903b9f565680`
Upload date	Sep 24, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.14.6`

Release files / qpuiq-0.48-py3-none-any.whl

Download URL	qpuiq-0.48-py3-none-any.whl
Size	78.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9915e8621f191fc4c13246ba666277b51a7aae4d873cf33dbca0a526a1ebae04`
BLAKE2b-256 checksum How to use checksums	`dac857e3ea230e9c299d6322a8666285f1af5943feba1e179df9301b18ea8ecc`
Upload date	Sep 24, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.14.6`