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
Official wheels target CPython 3.11–3.13 with matched Qt, PySide6, and Shiboken6 6.9.3 runtimes.
| Platform | Architectures |
|---|---|
| Windows | x64, ARM64 |
| macOS 12+ | x64, ARM64 |
| Linux | x64; ARM64 for CPython 3.12–3.13 |
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 →
1 maintainer
Metadata
1 maintainer
Release files for FluentQt 1.8.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
Total release size: 85.5 MB
Release files / fluentqt-1.8.5-cp313-cp313-win_arm64.whl
| Download URL | fluentqt-1.8.5-cp313-cp313-win_arm64.whl |
|---|---|
| Size | 4.0 MB |
| Tags | CPython 3.13 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
d53156b4db4aa192b72dfb53616b2551cde659630ef15aee32baaf5eb588630c
|
|
BLAKE2b-256 checksum How to use checksums |
6f1a4cc6208244598f99ef9b085dc68ab584ec87c7f597ea16dc2d215651ece3
|
| 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 Sep 18, 2026.
Transparency logRelease files / fluentqt-1.8.5-cp313-cp313-win_amd64.whl
| Download URL | fluentqt-1.8.5-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 4.1 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
a09e10d31e21ee2a4a29bb30e9182c656832c2a85705b3baae44be9234002439
|
|
BLAKE2b-256 checksum How to use checksums |
a3b626e0254c79f2e58284fde429d81b5a6d4d2330c588a7b6825daf2f6d1ede
|
| 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 Sep 18, 2026.
Transparency logRelease files / fluentqt-1.8.5-cp313-cp313-manylinux_2_39_aarch64.whl
| Download URL | fluentqt-1.8.5-cp313-cp313-manylinux_2_39_aarch64.whl |
|---|---|
| Size | 6.1 MB |
| Tags | CPython 3.13 Linux glibc 2.39+ ARM64 |
|
SHA-256 checksum How to use checksums |
8b8ac5a5afc8fcec09dc71a7e88cabcaffa6d3311e3f2826863ce46fbb50e078
|
|
BLAKE2b-256 checksum How to use checksums |
98685ec401d42c0f964be0c22fddb4fe00a539a0f9e6157e249dfd344798931c
|
| 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 Sep 18, 2026.
Transparency logRelease files / fluentqt-1.8.5-cp313-cp313-manylinux_2_28_x86_64.whl
| Download URL | fluentqt-1.8.5-cp313-cp313-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 6.4 MB |
| Tags | CPython 3.13 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
85e608cd37713497ccbb318ce3f7fcdbfba5f12d7b3b487eb6f1e281408851cd
|
|
BLAKE2b-256 checksum How to use checksums |
3695b2339ea2cf308cdc8fc7c4c9ec0677c3b8d5b16ee2b58d6703f4140fb9b7
|
| 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 Sep 18, 2026.
Transparency logRelease files / fluentqt-1.8.5-cp313-cp313-macosx_12_0_x86_64.whl
| Download URL | fluentqt-1.8.5-cp313-cp313-macosx_12_0_x86_64.whl |
|---|---|
| Size | 5.0 MB |
| Tags | CPython 3.13 macOS 12.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
c7d56f15e772d4254cb44498c55b9f55b00c1d234ec5ade47e3a62f7f1f0fc89
|
|
BLAKE2b-256 checksum How to use checksums |
c14ccf70f40919ee3e0737af9276cc7165b720e55909fc96c533d9cbdde191dc
|
| 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 Sep 18, 2026.
Transparency logRelease files / fluentqt-1.8.5-cp313-cp313-macosx_12_0_arm64.whl
| Download URL | fluentqt-1.8.5-cp313-cp313-macosx_12_0_arm64.whl |
|---|---|
| Size | 4.9 MB |
| Tags | CPython 3.13 macOS 12.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
66d0a0bbfcaa7ded9254dd0e128cc960358e31c907ea9b282f157edd3606741e
|
|
BLAKE2b-256 checksum How to use checksums |
a28e49f3aeeebd88539d4aa22a8e734f99abdb875f25ad01984eaf7ac40462d7
|
| 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 Sep 18, 2026.
Transparency logRelease files / fluentqt-1.8.5-cp312-cp312-win_arm64.whl
| Download URL | fluentqt-1.8.5-cp312-cp312-win_arm64.whl |
|---|---|
| Size | 4.0 MB |
| Tags | CPython 3.12 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
46f44033106fcf6dc29f03ded4fdf9d10bf54969cc19300a149a0f8ce719f299
|
|
BLAKE2b-256 checksum How to use checksums |
cc70c6dc297bd948fbd921af1c0240221e77cfa14d0c358fa6ec5c6ead293372
|
| 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 Sep 18, 2026.
Transparency logRelease files / fluentqt-1.8.5-cp312-cp312-win_amd64.whl
| Download URL | fluentqt-1.8.5-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 4.1 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
c35d4bb3022c44a6fd4c267a3e8f132d94691bedad5f4aa4570f5ddeaac13703
|
|
BLAKE2b-256 checksum How to use checksums |
382681ef42f2c7e1b57ada45b7c4c538861f4d4bc48134992a12ab1173476d36
|
| 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 Sep 18, 2026.
Transparency logRelease files / fluentqt-1.8.5-cp312-cp312-manylinux_2_39_aarch64.whl
| Download URL | fluentqt-1.8.5-cp312-cp312-manylinux_2_39_aarch64.whl |
|---|---|
| Size | 6.1 MB |
| Tags | CPython 3.12 Linux glibc 2.39+ ARM64 |
|
SHA-256 checksum How to use checksums |
0e254b527426d195c7ccf75b16e3bdc8be3067e06b38c35494ce14f93220ddd1
|
|
BLAKE2b-256 checksum How to use checksums |
725d60054d34ea79eb0348e13a0afcea8ab6194fcc6e5b805338922a41f908ed
|
| 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 Sep 18, 2026.
Transparency logRelease files / fluentqt-1.8.5-cp312-cp312-manylinux_2_28_x86_64.whl
| Download URL | fluentqt-1.8.5-cp312-cp312-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 6.4 MB |
| Tags | CPython 3.12 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
24c1b2ca54607f5dd5e9030efc69a33360d9f82a9f8609389957182e6c564563
|
|
BLAKE2b-256 checksum How to use checksums |
9eaadc55605d4c165d50fd7215c59017046a92e8dbe0cc22daff2df30901c305
|
| 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 Sep 18, 2026.
Transparency logRelease files / fluentqt-1.8.5-cp312-cp312-macosx_12_0_x86_64.whl
| Download URL | fluentqt-1.8.5-cp312-cp312-macosx_12_0_x86_64.whl |
|---|---|
| Size | 5.0 MB |
| Tags | CPython 3.12 macOS 12.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
fd8d015089f3d72967914998421db9aa11ea7d39a48e6b4470722881c54997f3
|
|
BLAKE2b-256 checksum How to use checksums |
5d54ad601aee2d7dd6767ad08702ffb7a46ee27171a2e8797fe025bc536fc3ac
|
| 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 Sep 18, 2026.
Transparency logRelease files / fluentqt-1.8.5-cp312-cp312-macosx_12_0_arm64.whl
| Download URL | fluentqt-1.8.5-cp312-cp312-macosx_12_0_arm64.whl |
|---|---|
| Size | 4.9 MB |
| Tags | CPython 3.12 macOS 12.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
55ea68e841c019af227c693d799601041ef847b54173ff54b07902b77e55824e
|
|
BLAKE2b-256 checksum How to use checksums |
a1d04fe57f01076c36a70f8e570a30c6d6b35a2bdc6003de05718cadef300dd4
|
| 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 Sep 18, 2026.
Transparency logRelease files / fluentqt-1.8.5-cp311-cp311-win_arm64.whl
| Download URL | fluentqt-1.8.5-cp311-cp311-win_arm64.whl |
|---|---|
| Size | 4.0 MB |
| Tags | CPython 3.11 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
44ac7fcc66b8fd119a532e75fd2e4a65d535da3c7ee8838891ba42224e420b28
|
|
BLAKE2b-256 checksum How to use checksums |
4fdbd08682ddf402b6edec8dbb98bb831279cedbab13cf600a65e554c4a8791b
|
| 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 Sep 18, 2026.
Transparency logRelease files / fluentqt-1.8.5-cp311-cp311-win_amd64.whl
| Download URL | fluentqt-1.8.5-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 4.1 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
2d47ecec92090da82ef90a0219cd2fb5c4a0dbfc99be177e4727198202ec8280
|
|
BLAKE2b-256 checksum How to use checksums |
d1a8ece033de29f9af2e7a0033d5f89be588446bd34820e251742150db31a76a
|
| 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 Sep 18, 2026.
Transparency logRelease files / fluentqt-1.8.5-cp311-cp311-manylinux_2_28_x86_64.whl
| Download URL | fluentqt-1.8.5-cp311-cp311-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 6.4 MB |
| Tags | CPython 3.11 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
eba6a1560d2e54ff87ee9112a501ba073ebdf35123da5c9226ea5a3302b342ca
|
|
BLAKE2b-256 checksum How to use checksums |
b2838941238e8b8572dd1e325b3f3550356e3fd5eabc738836ed632df2026c21
|
| 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 Sep 18, 2026.
Transparency logRelease files / fluentqt-1.8.5-cp311-cp311-macosx_12_0_x86_64.whl
| Download URL | fluentqt-1.8.5-cp311-cp311-macosx_12_0_x86_64.whl |
|---|---|
| Size | 5.0 MB |
| Tags | CPython 3.11 macOS 12.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
a74b3237a27f585ebd1d39ab068536de8c0a57df71d0587ff6925ad44fe1bfb6
|
|
BLAKE2b-256 checksum How to use checksums |
bd4741dbf486f28b2ad6784af7832baf460c0d18c2b99820059b8d9f1d1cbd57
|
| 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 Sep 18, 2026.
Transparency logRelease files / fluentqt-1.8.5-cp311-cp311-macosx_12_0_arm64.whl
| Download URL | fluentqt-1.8.5-cp311-cp311-macosx_12_0_arm64.whl |
|---|---|
| Size | 4.9 MB |
| Tags | CPython 3.11 macOS 12.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
6ad53030ac55df1eb559c05dee607db0feeca94435b0a7f85c7f667b1345ed14
|
|
BLAKE2b-256 checksum How to use checksums |
441c7b42b6d4d7eeadbaff52f9d632f457ad7ac2619bdfe76ee4ddf8a1e5af9e
|
| 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 Sep 18, 2026.
Transparency log
