Skip to content


Repository files navigation


A tool for making simple Python GUIs

Guietta is a tool that makes simple GUIs simple:

from guietta import _, Gui, Quit
gui = Gui(
	[ "Enter numbers:",  "__a__", "+", "__b__", ["Calculate"] ],
	[    "Result: -->", "result",   _,       _,             _ ],
	[                _,        _,   _,       _,          Quit ]

with gui.Calculate:
	gui.result = float(gui.a) + float(gui.b)

And here it is:

Example GUI

Also featuring:

  • matplotlib and pyqtgraph integration, for easy event-driven plots
  • easily display columns of data in labels using lists and dicts
  • multiple windows
  • customizable behaviour in case of exceptions
  • queue-like mode (a la PySimpleGUI)
  • integrate any QT widget seamlessly, even your custom ones (as long as it derives from QWidget, it is OK)
  • easy background processing for long-running operations
  • ordinary QT signals/slots, accepting any Python callable, if you really want to use them


pip install guietta

If you use conda, please read our page on QT incompatibilities with conda.

Install on older platforms

Guietta uses the PySide2 QT binding by default, and some systems (older Macs, Raspberry PI) do not have it available. Guietta can fallback to the PyQt5 binding if available, but does not specify it as an automatic dependency. If you get an installation error about PySide2, try to use PyQt5 instead using the following:

    pip install guietta --no-deps
    pip install pyqt5


Stable version:

Latest update from github:


Documentation Status