Build Beautiful GUIs with Python (PySide) and Qt framework

✨ About this project

This repository is your complete guide to building sleek, modern graphical user interfaces with Python (PySide) and Qt framework. Whether you're a beginner or an experienced developer, you'll find practical tutorials, tips, and real code examples to level up your projects.

If this content has helped you, please consider making a donation. Your support makes a real difference and helps the project grow! 💙

🛠 Technologies used

👨‍💻 Author

Crafted with 💙 by Renato Cruz. Got questions or feedback? Reach out anytime!

What I'm listening to while I code or study 😎🎵:

💝 Support This Project

Your donation keeps this project alive and helps me continue creating and sharing useful content.

GitHub Sponsors

https://github.com/sponsors/natorsc/

Pix (Brazil)

b1839493-2afe-484d-9272-82a3e402b36f

---

💡 Extra

Qt

• Documentation Qt 6.

Kirigami

• Kirigami.

KDE

• Official website.
• Blogs.

Softwares

• KDE Apps.

PySide6

Main commands:

• pyside6-android-deploy.
• pyside6-assistant.
• pyside6-balsam.
• pyside6-balsamui.
• pyside6-deploy.
• pyside6-designer.
• pyside6-genpyi.
• pyside6-linguist.
• pyside6-lrelease.
• pyside6-lupdate.
• pyside6-metaobjectdump.
• pyside6-project.
• pyside6-qml.
• pyside6-qmlcachegen.
• pyside6-qmlformat.
• pyside6-qmlimportscanner.
• pyside6-qmllint.
• pyside6-qmlls.
• pyside6-qmltyperegistrar.
• pyside6-qsb.
• pyside6-qtpy2cpp.
• pyside6-rcc.
• pyside6-svgtoqml.
• pyside6-uic.

---

Flatpak

Pip generator

• flatpak-pip-generator

PySide6

• PySide.BaseApp.

Example:

{
  "id": "com.github.natorsc.AppName",
  "runtime": "org.kde.Platform",
  "runtime-version": "6.9",
  "sdk": "org.kde.Sdk",
  "base": "io.qt.PySide.BaseApp",
  "base-version": "6.9",
  "command": "app-name",
  "cleanup-commands": [
    "- /app/cleanup-BaseApp.sh"
  ],
  "finish-args": [
    "--share=ipc",
    "--socket=wayland",
    "--socket=x11",
    "--socket=pulseaudio",
    "--device=dri"
  ],
  "modules": [
    {
      "name": "app-name",
      "buildsystem": "simple",
      "build-commands": [
        "pip3 install --verbose --exists-action=i --no-index --find-links=\"file://${PWD}\" --prefix=${FLATPAK_DEST} \"app_name\" --no-build-isolation"
      ],
      "sources": [
        {
          "type": "file",
          "path": "./dist/app_name-0.1.0-py3-none-any.whl"
        }
      ]
    }
  ]
}

PyQt6

• PyQt.BaseApp.

Example:

{
  "id": "com.github.natorsc.AppName",
  "runtime": "org.kde.Platform",
  "runtime-version": "6.9",
  "sdk": "org.kde.Sdk",
  "base": "com.riverbankcomputing.PyQt.BaseApp",
  "base-version": "6.9",
  "command": "app-name",
  "cleanup-commands": [
    "- /app/cleanup-BaseApp.sh"
  ],
  "finish-args": [
    "--share=ipc",
    "--socket=wayland",
    "--socket=x11",
    "--socket=pulseaudio",
    "--device=dri"
  ],
  "modules": [
    {
      "name": "app-name",
      "buildsystem": "simple",
      "build-commands": [
        "pip3 install --verbose --exists-action=i --no-index --find-links=\"file://${PWD}\" --prefix=${FLATPAK_DEST} \"app_name\" --no-build-isolation"
      ],
      "sources": [
        {
          "type": "file",
          "path": "./dist/app_name-0.1.0-py3-none-any.whl"
        }
      ]
    }
  ]
}

---

Github actions

If necessary, create a file for each operating system.

name: Deploying PySide6 with Nuitka ⚙️.
on:
  push:
    branches: ['main']
  workflow_dispatch:

permissions:
  contents: read
  pages: write
  id-token: write

concurrency:
  group: 'deploy'
  cancel-in-progress: true

jobs:
  build:
    strategy:
      matrix:
        os: [ubuntu-latest, macos-latest, windows-latest]
    runs-on: '${{ matrix.os }}'
    steps:
      - name: Check out repository 💾.
        uses: actions/checkout@v5
      
      - name: Install Python 🐍.
        uses: actions/setup-python@v5
        with:
            python-version: '3.11'
            architecture: 'x64'
            cache: 'pip'
            cache-dependency-path: |
              **/requirements*.txt

      - name: Install requirements 🔨.
        working-directory: .
        run: python -m pip install --upgrade pip && pip install -r requirements.txt

      - name: Install and configure Nuitka 🛠️.
        uses: Nuitka/Nuitka-Action@main
        with:
          nuitka-version: main
          script-name: path/to/the/script.py
          enable-plugins: pyside6
          quiet: true
          standalone: true
          disable-console: true
          macos-create-app-bundle: true
          output-file: nome-do-aplicativo
          linux-icon: path/to/the/icon.ico
          windows-icon-from-ico: path/to/the/icon.ico
          macos-app-icon: path/to/the/con.icns
          macos-app-name: nome-do-aplicativo

      - name: Upload artifact (onefile) 🚀.
        uses: actions/upload-artifact@v4
        with:
          name: '${{ runner.os }}-build'
          path: |
            build/app.dist
            build/*.exe
            build/*.bin
            build/*.app/**/*

---

QtSql

QSQLITE (SQLite3)

• Python.

QPSQL (PostgreSQL)

• Python.
• Docker compose.

Arch Linux

sudo pacman -S \
postgresql-libs

QMARIADB (MariaDB)

• Python.
• Docker compose.

Arch Linux

sudo pacman -S \
mariadb-libs

QMYSQL (MySQL)

• Python.
• Docker compose.

Arch Linux

sudo pacman -S \
mariadb-libs

---

KDE Kirigami

Kirigami is a KDE UI (User Interface) framework designed to make it easier to create convergent and responsive applications.

Dependências

Arch Linux

sudo pacman -S \
pyside6 \
kirigami \
flatpak-builder \
qqc2-desktop-style \
appstream

PyQt6: sudo pacman -S python-pyqt6.

Fedora

sudo dnf install \
python3-pyside6 \
kf6-kirigami-devel \
flatpak-builder \
qqc2-desktop-style \
appstream-compose

PyQt6: sudo dnf install python3-pyqt6.

openSuse

sudo zypper install \
python3-qt6 \
python3-pyside6 \
kf6-kirigami-devel \
flatpak-builder \
qqc2-desktop-style \
AppStream-compose

PyQt6: sudo zypper install python-PyQt6.

Abstract card

Code:

• Python.
• QML.

Application window

Code:

• Python.
• QML.

Card

Code:

• Python.
• QML.

Chips

Code:

• Python.
• QML.

Dialog

Code:

• Python.
• QML.

Dialog menu

Code:

• Python.
• QML.

Dialog prompt

Code:

• Python.
• QML.

Global drawer

Code:

• Python.
• QML.

Global drawer context

ToDo.

Code:

• Python.
• QML.

Global drawer desktop

Code:

• Python.
• QML.

Global drawer header

Code:

• Python.
• QML.

Overlay drawer

Code:

• Python.
• QML.

---

Qt Quick

Application window

Code:

• Python.
• QML.

---

Busy indicator

Code:

• Python.
• QML.

---

Button

Code:

• Python.
• QML.

---

Button group

Code:

• Python.
• QML.

---

Charts

Arch Linux:

sudo pacman -S \
qt6-charts

Fedora:

sudo dnf install \
qt6-charts

Ubuntu 25.04:

sudo apt install \
qml6-module-qtcharts

---

Area series

Code:

• Python
• QML

---

Bar series

Code:

• Python
• QML

---

Horizontal bar series

Code:

• Python
• QML

---

Horizontal percent bar series

Code:

• Python
• QML

---

Horizontal stacked bar series

Code:

• Python
• QML

---

Line series

Code:

• Python
• QML

---

Percent bar series

Code:

• Python
• QML

---

Pie donut series

Code:

• Python
• QML

---

Pie series

Code:

• Python
• QML

---

Scatter series

Code:

• Python
• QML

---

Spline series

Code:

• Python
• QML

---

Stacked bar series

Code:

• Python
• QML

---

Check box

Code:

• Python.
• QML.

---

Check delegate

Code:

• Python.
• QML.

---

Color dialog

Code:

• Python.
• QML.

---

Column layout

Code:

• Python.
• QML.

---

Combo box

Code:

• Python.
• QML.

---

Day of week row

Code:

• Python.
• QML.

---

Delay button

Code:

• Python.
• QML.

---

Dial

Code:

• Python.
• QML.

---

Dialog

Code:

• Python.
• QML.

---

Drawer

Code:

• Python.
• QML.

---

File dialog

Code:

• Python.
• QML.

---

Folder dialog

Code:

• Python.
• QML.

---

Font dialog

Code:

• Python.
• QML.

---

Frame

Code:

• Python.
• QML.

---

Grid Layout

Code:

• Python.
• QML.

---

Group box

Code:

• Python.
• QML.

---

Import QML file

Code:

• Python.
• QML.

---

Item delegate

Code:

• Python.
• QML.

---

Layout item proxy

Code:

• Python.
• QML.

---

Message dialog

Code:

• Python.
• QML.

---

Overlay

Code:

• Python.
• QML.

---

Popup

Code:

• Python.
• QML.

---

Row layout

Code:

• Python.
• QML.

---

Set initial properties

Todo

Code:

• Python.
• QML.

---

Stack layout

Code:

• Python.
• QML.

---

Text field

Code:

• Python.
• QML.

---

Text input

Code:

• Python.
• QML.

---

Translation

Code:

• Python.
• QML.

---

Tree view

Code:

• Python.
• QML.

---

Qt widgets

QApplication

Code:

• Python.

QBoxLayout

Code:

• Python.

QButtonGroup

Code:

• Python.

QCalendarWidget

Code:

• Python.

QCheckBox

Code:

• Python.

QColorDialog

Code:

• Python.

QColumnView

Code:

• Python.

QComboBox

Code:

• Python.

QCompleter

Code:

• Python.

QDateEdit

Code:

• Python.

QDateTimeEdit

Code:

• Python.

QDial

Code:

• Python.

QDialog

Code:

• Python.

QDialogButtonBox

Code:

• Python.

QDockWidget

Code:

• Python.

QDoubleSpinBox

Code:

• Python.

QErrorMessage

Code:

• Python.

QFileDialog

Code:

• Python.

QFontComboBox

Code:

• Python.

QFontDialog

Code:

• Python.

QFormLayout

Code:

• Python.

QFrame

Code:

• Python.

QGridLayout

Code:

• Python.

QGroupBox

Code:

• Python.

QHBoxLayout

Code:

• Python.

QInputDialog

Code:

• Python.

QLabel

Code:

• Python.

QLCDNumber

Code:

• Python.

QLineEdit

Code:

• Python.

QListView

Code:

• Python.

QListWidget

Code:

• Python.

QMainWindow

Code:

• Python.

QSystemTrayIcon

Code:

• Python.

---