Install FluentQt from PyPI
Status: Current package guide
Documentation › Python bindings › Get started and examples
Contents · Python bindings index · FluentQt PySide6 Hello World →
FluentQt is the official PySide6 compatibility distribution for Fluent-Qt, a cross-platform Fluent / WinUI-style C++ component library built on Qt Widgets. The widgets remain native C++ objects; Shiboken6 exposes the same implementation to Python instead of reimplementing the UI library.
The C++ library remains the primary project. Python support is optional and targets Qt 6.
Install
python -m pip install FluentQt
Published wheels install the matching PySide6-Essentials and shiboken6
runtime automatically.
Minimal example
import sys
import fluentqt
from PySide6.QtCore import Qt
from PySide6.QtWidgets import QApplication, QVBoxLayout, QWidget
from fluentqt.basicinput import Button
from fluentqt.windowing import Window
fluentqt.prepare_high_dpi_application()
app = QApplication(sys.argv)
fluentqt.initialize_resources()
app.setFont(fluentqt.font_for_role(fluentqt.FontRole.Body))
window = Window()
window.setWindowTitle("FluentQt Hello World")
window.resize(480, 320)
content = QWidget()
layout = QVBoxLayout(content)
button = Button("Hello from FluentQt", content)
button.setFluentStyle(Button.ButtonStyle.Accent)
layout.addWidget(button, 0, Qt.AlignCenter)
window.setContentWidget(content)
window.show()
sys.exit(app.exec())
Package contents
- Native Qt Widgets with the Fluent design contract and Light/Dark themes.
- Qt properties, signals, enums, Python subclassing, and typed package stubs.
- Explicit ownership contracts for hosted widgets, overlays, models, and native windows.
- A single
_fluentqtextension so themes, resources, and Qt object identity stay process-wide.
The example application is distributed separately as
FluentQt-Gallery, keeping demo
code and assets out of the reusable UI library wheel.
Compatibility
Each supported platform and architecture has a CPython stable-ABI (abi3)
wheel for the matched Qt, PySide6, and Shiboken6 6.9.3 runtimes. The wheels
support CPython 3.11–3.13, except on Linux ARM64 where the minimum is 3.12.
| Platform | Architectures |
|---|---|
| Windows | x64, ARM64 |
| macOS 12+ | x64, ARM64 |
| Linux | x64, ARM64 |
The source binding keeps Qt/PySide/Shiboken 6.2.4 as its minimum compatibility baseline. All Qt for Python components and the C++ Qt SDK must use the same version and architecture.
Project links
FluentQt is released under the MIT License. Microsoft product names and Fluent design references are used only to describe compatibility and visual style.
Contents · Python bindings index · FluentQt PySide6 Hello World →
Metadata
Release files for FluentQt 1.12.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Actions Reset | |||
|---|---|---|---|---|
| fluentqt-1.12.1-cp312-abi3-manylinux_2_39_aarch64.whl | CPython 3.12 | abi3 | Linux glibc 2.39+ ARM64 | Details for fluentqt-1.12.1-cp312-abi3-manylinux_2_39_aarch64.whl |
| fluentqt-1.12.1-cp311-abi3-win_arm64.whl | CPython 3.11 | abi3 | Windows ARM64 | Details for fluentqt-1.12.1-cp311-abi3-win_arm64.whl |
| fluentqt-1.12.1-cp311-abi3-win_amd64.whl | CPython 3.11 | abi3 | Windows x86-64 | Details for fluentqt-1.12.1-cp311-abi3-win_amd64.whl |
| fluentqt-1.12.1-cp311-abi3-manylinux_2_28_x86_64.whl | CPython 3.11 | abi3 | Linux glibc 2.28+ x86-64 | Details for fluentqt-1.12.1-cp311-abi3-manylinux_2_28_x86_64.whl |
| fluentqt-1.12.1-cp311-abi3-macosx_12_0_x86_64.whl | CPython 3.11 | abi3 | macOS 12.0+ x86-64 | Details for fluentqt-1.12.1-cp311-abi3-macosx_12_0_x86_64.whl |
| fluentqt-1.12.1-cp311-abi3-macosx_12_0_arm64.whl | CPython 3.11 | abi3 | macOS 12.0+ ARM64 | Details for fluentqt-1.12.1-cp311-abi3-macosx_12_0_arm64.whl |
Total release size: 38.0 MB
Release files / fluentqt-1.12.1-cp312-abi3-manylinux_2_39_aarch64.whl
| Download URL | fluentqt-1.12.1-cp312-abi3-manylinux_2_39_aarch64.whl |
|---|---|
| Size | 7.8 MB |
| Tags | CPython 3.12 Linux glibc 2.39+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
f4560ea3d645858fc88728eadba703d1d82c3825321095ca76a0bc6abb3e5ea6
|
|
BLAKE2b-256 checksum How to use checksums |
fe424d8777dd0090cfbee2a1938928cb7044960662d66e2f625ac2582e6b7644
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.
Transparency logRelease files / fluentqt-1.12.1-cp311-abi3-win_arm64.whl
| Download URL | fluentqt-1.12.1-cp311-abi3-win_arm64.whl |
|---|---|
| Size | 4.8 MB |
| Tags | CPython 3.11 Windows ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
94accdf4f4d399f3040471221700e215a476493fbd4002f7d984795c74cc7778
|
|
BLAKE2b-256 checksum How to use checksums |
21568959fd388898cd4cb5f575a5aa6569ca2460ea7663a8ca1366e06a1ead8c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.
Transparency logRelease files / fluentqt-1.12.1-cp311-abi3-win_amd64.whl
| Download URL | fluentqt-1.12.1-cp311-abi3-win_amd64.whl |
|---|---|
| Size | 5.0 MB |
| Tags | CPython 3.11 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
80e0b4c970428948e328c760c0d9ea749f96a7e6aba4ae6fd4264385b2b8c2fc
|
|
BLAKE2b-256 checksum How to use checksums |
2fd31f3a30078e36a35efc35dbdc8095bde965ce12ff4433befc68afd97daf32
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.
Transparency logRelease files / fluentqt-1.12.1-cp311-abi3-manylinux_2_28_x86_64.whl
| Download URL | fluentqt-1.12.1-cp311-abi3-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 8.1 MB |
| Tags | CPython 3.11 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
d16fbf9ce7124e3eb1cf2d137e625db014a02d58dc220dcd2a09155bb32fdce8
|
|
BLAKE2b-256 checksum How to use checksums |
4c162abc3fa2e5c7c45cf92d8b126f7c90a840d83c4f1c0467c7b2793b6488f2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.
Transparency logRelease files / fluentqt-1.12.1-cp311-abi3-macosx_12_0_x86_64.whl
| Download URL | fluentqt-1.12.1-cp311-abi3-macosx_12_0_x86_64.whl |
|---|---|
| Size | 6.2 MB |
| Tags | CPython 3.11 abi3 macOS 12.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
b5caf78f6c03f39f1d5fe01c579ea7feb30f0ff36a3c36fd5d82b1da24c1382e
|
|
BLAKE2b-256 checksum How to use checksums |
3ee4f7e1beb49897a573b9ae12b0e2467d9d3f502632cc44aa5f5d3164ba8a60
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.
Transparency logRelease files / fluentqt-1.12.1-cp311-abi3-macosx_12_0_arm64.whl
| Download URL | fluentqt-1.12.1-cp311-abi3-macosx_12_0_arm64.whl |
|---|---|
| Size | 6.0 MB |
| Tags | CPython 3.11 abi3 macOS 12.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
2e8d7c6494304fcdfd1a2b5eea2e4686e6d554a35cb81bb2f62a39420732e5d8
|
|
BLAKE2b-256 checksum How to use checksums |
2f4ecf51986fa6776a9d32aab9ed6c16f7c014bb023b55acaf1ad741676de5cc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.
Transparency logSecurity for FluentQt 1.12.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 6 files in this release have been uploaded with provenance metadata.
Attestation for fluentqt-1.12.1-cp312-abi3-manylinux_2_39_aarch64.whl
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.