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.

flatpak install org.kde.Platform/x86_64/6.9 org.kde.Sdk/x86_64/6.9

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.

The Kirigami framework cannot be used within virtual environments (venv, poetry, pdm, uv, etc).

Dependências

Arch Linux

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

PyQt6: sudo pacman -S python-pyqt6.

Fedora

sudo dnf install \
python3-lsp-server \
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.

---