---
id: pyside6-fluent-widgets
version: "1.11.3"
license: GPLv3
license_treatment: copyleft
maintenance: active
---

# PySide6-Fluent-Widgets — A fluent design widgets library based on PySide6

License: copyleft · Maintenance: active · Downloads: 90.4K/mo

## What it is and what it does

PySide6-Fluent-Widgets is a widget library that brings Microsoft's Fluent Design System to PySide6 applications. It wraps PySide6 with pre-built, styled components that follow Windows design guidelines, so you can build modern desktop UIs without hand-coding every visual detail. The library depends on PySide6 for the underlying Qt bindings, PySideSix-Frameless-Window for custom window chrome, and darkdetect to adapt the UI to system light/dark mode.

The package is distributed in two variants: a standard version and a full-featured version (installable with [full]) that includes additional components like AcrylicLabel. It's actively maintained with 90409 monthly downloads and comprehensive documentation. Non-commercial use is free under GPLv3, but commercial applications require a paid license.

Use it for:

- Build a desktop application with a modern Windows Fluent Design look without manually styling every control.
- Create a cross-platform tool that adapts its UI theme to the system's light or dark mode preference.
- Develop an internal utility or data-entry application that needs professional appearance with minimal design effort.
- Prototype a Windows-native UI quickly using fluent components in Qt Designer.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides fluent design UI widgets for PySide6 applications, enabling developers to build modern Windows-style interfaces.

Yes, if you are building a non-commercial PySide6 application and want a modern Windows-style UI without extensive custom styling. The library is actively maintained, well-documented, and has no known vulnerabilities. For commercial use, you must purchase a license. Installation friction is low and dependencies are standard.

## Install

pip install pyside6-fluent-widgets
uv add pyside6-fluent-widgets
poetry add pyside6-fluent-widgets

## Installing PySide6-Fluent-Widgets

Before you install: Installation is straightforward with low friction; the package is actively maintained with a recent release 13 days old and 8067 repository stars. Three runtime dependencies are standard Python packages.

License in practice: Licensed under GPLv3 for non-commercial use; commercial applications require a separate commercial license. Using this in a proprietary product without a license creates legal exposure.

Quickstart:

pip install PySide6-Fluent-Widgets

from qfluentwidgets import FluentWindow
from PySide6.QtWidgets import QVBoxLayout

window = FluentWindow()
window.show()

Verify before relying:

- Whether the full-featured version with AcrylicLabel requires additional system dependencies or compilation steps.
- Exact Python version compatibility (requires_python is unspecified in the fact sheet).
- Performance characteristics or memory footprint when rendering large numbers of fluent widgets.

## Package facts

- License: GPLv3 (copyleft)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 90.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pyside6 fluent widgets, windows fluent design ui, modern pyside6 components, fluent design system python, pyside6 ui library, qt fluent widgets, ui-framework, windows-design, pyside6

[View on SkillFed](https://skillfed.io/packages/pyside6-fluent-widgets) · [View on PyPI](https://pypi.org/project/pyside6-fluent-widgets/)