A fluent design widgets library based on PyQt5

English | 简体中文 | 官网

To install lite version (AcrylicLabel is not available):

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

Or install full-featured version:

pip install "PyQt-Fluent-Widgets[full]" -i https://pypi.org/simple/

If you are using PySide2, PySide6 or PyQt6, you can download the code in PySide2, PySide6 or PyQt6 branch.

The Pro version library contains more advance components. You can download PySide6-Fluent-Widgets-Pro-Gallery.7z from the release page for preview purposes.

C++ QFluentWidgets require purchasing a license from the official website and contact [email protected] to retrieve the library. You can also download the compiled demo QFluentWidgets_v*.*.*.zip from the release page.

Warning Don't install PyQt-Fluent-Widgets, PyQt6-Fluent-Widgets, PySide2-Fluent-Widgets and PySide6-Fluent-Widgets at the same time, because their package names are all qfluentwidgets.

After installing PyQt-Fluent-Widgets package using pip, you can run any demo in the examples directory, for example:

cd examples/gallery
python demo.py

If you encounter ImportError: cannot import name 'XXX' from 'qfluentwidgets', it indicates that the package version you installed is too low. You can replace the mirror source with https://pypi.org/simple and reinstall again.

Want to know more about PyQt-Fluent-Widgets? Please read the help document 👈

PyQt-Fluent-Widgets is licensed under GPLv3 for non-commercial project. For commercial use, please purchase a commercial license.

Copyright © 2021 by zhiyiYo.

Check out this ▶ example video that shows off what PyQt-Fluent-Widgets are capable of 🎉

You can use PyQt-Fluent-Widgets in QtDesigner directly by running python ./tools/designer.py. If the operation is successful, you should be able to see the PyQt-Fluent-Widgets in the sidebar of QtDesigner.

You can also download the compiled QtDesigner from release page. Download and unzip FluentDesigner_v*.*.*.zip, then run designer/designer.exe, you will launch the QtDesigner that has already installed plugins.

Note It is recommended to install pyqt5-tools and PyQt-Fluent-Widgets in a virtual environment. Please make sure PyQt-Frameless-Window >= 0.2.7.

If this project helps you a lot and you want to support the development and maintenance of this project, feel free to sponsor me via 爱发电 or ko-fi. Your support is highly appreciated 🥰

Here are some projects based on PyQt-Fluent-Widgets:

• zhiyiYo/QMaterialWidgets: A material design widgets library based on PyQt/PySide
• zhiyiYo/Groove: A cross-platform music player based on PyQt5
• zhiyiYo/Alpha-Gobang-Zero: A gobang robot based on reinforcement learning

• Windows design: Design guidelines and toolkits for creating native app experiences
• Microsoft/WinUI-Gallery: An app demonstrates the controls available in WinUI and the Fluent Design System