「 PyHuskarUI 」 Modern UI for PySide6 and Qml
June 23, 2026 · View on GitHub
✨ Features
- 📦 A set of high-quality Qml components out of the box.
- 🎨 Powerful theme customization system.
- 💻 Based on Qml, completely cross platform.
- 🔧 Highly flexible delegate based component customization.
- 🤖 AI-assisted development support.
🗺️ Roadmap
The development plan can be found here: Component Roadmap.
Anyone can discuss through issues, QQ groups, or WeChat groups, and ultimately meaningful components/functions will be added to the development plan.
🤖 AI Agent Assisted Development
Note
Intelligent agent skills
This warehouse provides two intelligent agent skills:
huskarui:: Use Python to query the documentation, properties, and examples of HuskarUI components from the repository metadata.qmlpreview:: Useqmlsceneto preview the currently edited QML file and capture a screenshot of the run to the clipboard.
They are designed specifically for AI Agent programming tools such as Claude Code and Codex. It can help you:
- Quickly query component documents and properties
- Obtain scenario based development examples
- Automatically iterate and preview code
👉 See AI Agent Skill Guide for more details.
🔖 Online Document
🌐 Online wiki
📺 Online Demo
🗂️ Precompiled package
Precompiled packages and binary libraries for three platforms, Windows / MacOS / Linux, have been created.
Please visit Release to download.
🌠 Install
- Use pypi package
uv pip install pyhuskarui
🔨 How to Build
- Clone
git clone --recursive https://github.com/mengps/PyHuskarUI.git
- Build
uv sync
uv run init
uv build pyhuskarui
- Install
uv pip install [-e] ./pyhuskarui - Run Gallery
uv run ./gallery/main.py
📦 Get started
- Create QtQuick application
QtVersion >= 6.8 - Add the following code to your
main.py
...
from pyhuskarui.husapp import HusApp
if __name__ == "__main__":
...
app = QGuiApplication(sys.argv)
engine = QQmlApplicationEngine()
HusApp.initialize(engine)
...
- Add the following code to your
Main.qml
import HuskarUI.Basic
HusWindow {
...
}
Alright, you can now enjoy using PyHuskarUI.
🚩 Reference
- Ant-d Components: https://ant-design.antgroup.com/components/overview
- Ant Design: https://ant-design.antgroup.com/docs/spec/introduce
💓 LICENSE
Use Apache License 2.0