Repolode
Submit
zhiyiYo

zhiyiYo/PyQt-Fluent-Widgets

A PyQt/PySide widget library that brings Microsoft Fluent Design-style controls to Qt desktop apps.

View on GitHubWebsite
Stars
8,162
Forks
777
Open issues
28
Last commit
6 days ago

What is it?

PyQt-Fluent-Widgets is a component library for building Qt desktop applications with the Windows 11 Fluent Design look. It provides ready-made navigation interfaces, buttons, dialogs, input controls and other widgets styled after WinUI, so developers can avoid hand-styling each Qt control.

The main package targets PyQt5 and is installed from PyPI as qfluentwidgets. Separate branches cover PySide2, PySide6 and PyQt6. The project supports Windows, Linux and macOS, and ships an example gallery that demonstrates the components.

The library is licensed under GPLv3 for non-commercial use; commercial use requires a separate license. A Pro edition with additional components is offered on the project's website.

Key features

  • 01Fluent-styled buttons, navigation panels, dialogs and input controls for Qt.
  • 02Supports PyQt5 with separate branches for PySide2, PySide6 and PyQt6.
  • 03Runs on Windows, Linux and macOS.
  • 04Includes an example gallery demonstrating the available components.
  • 05Offers a full-featured install option that adds acrylic effect labels.

Use cases

  • Building a modern-looking Python desktop application with a Windows 11 style interface.
  • Adding a sidebar navigation layout to an existing PyQt or PySide tool.
  • Prototyping a Qt GUI quickly without hand-styling every control.

Quick start

  1. 1

    Install the lite PyQt5 version from PyPI

    pip install PyQt-Fluent-Widgets -i https://pypi.org/simple/
  2. 2

    Run an example demo from the examples directory

    cd examples/gallery python demo.py

Things to know

  • Licensed under GPLv3 for non-commercial use; commercial use requires buying a commercial license.
  • The README warns that PyQt-Fluent-Widgets and its PyQt6, PySide2 and PySide6 variants share the same package name and must not be installed together.
  • The PyPI package targets PyQt5; PySide2, PySide6 and PyQt6 need separate branches.

In collections

Desktop GUI apps & toolkits

Topics

#pyqt#qt#gui#fluent-design#desktop-app#widgets#python#custom#fluent#fluentui

FAQ

What is PyQt-Fluent-Widgets?
A PyQt/PySide widget library that brings Microsoft Fluent Design-style controls to Qt desktop apps. PyQt-Fluent-Widgets is a component library for building Qt desktop applications with the Windows 11 Fluent Design look. It provides ready-made navigation interfaces, buttons, dialogs, input controls and other widgets styled after WinUI, so developers can avoid hand-styling each Qt control.
Is PyQt-Fluent-Widgets free to use? What license does it have?
PyQt-Fluent-Widgets is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is PyQt-Fluent-Widgets still maintained?
Actively maintained. The last commit to PyQt-Fluent-Widgets was on Nov 1, 2026.
What can I use PyQt-Fluent-Widgets for?
Building a modern-looking Python desktop application with a Windows 11 style interface. Adding a sidebar navigation layout to an existing PyQt or PySide tool. Prototyping a Qt GUI quickly without hand-styling every control.
How do I install PyQt-Fluent-Widgets?
Install the lite PyQt5 version from PyPI: pip install PyQt-Fluent-Widgets -i https://pypi.org/simple/ Run an example demo from the examples directory: cd examples/gallery python demo.py
Where can I get PyQt-Fluent-Widgets?
The source code and installation instructions are on GitHub: https://github.com/zhiyiYo/PyQt-Fluent-Widgets

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects