✨ 特性

• 📦 一套开箱即用的优质 Qml 组件.
• 🎨 强大的主题定制系统.
• 💻 基于Qml，完全跨平台.
• 🔧 高度灵活的基于委托的组件定制.
• 🤖 AI 辅助开发支持.

🗺️ 路线图

开发计划可以在这里看到: 组件路线图.

任何人都可以通过 issue/qq群/wx群 进行讨论, 最终有意义的组件/功能将添加到开发计划.

🤖 AI Agent 辅助开发

👉 查看 AI Agent 技能使用指南 了解更多。

🔖 在线文档

• 组件文档

🌐 在线 wiki

• PyHuskarUI 在线 wiki (AI)

📺 在线演示

• 哔哩哔哩

🗂️ 预编译包

预编译了三个平台的 Windows / MacOS / Linux 程序包和二进制库包.

前往 Release 中下载.

🌠 安装

• 使用 pypi 包

  uv pip install pyhuskarui
  

🔨 如何构建

• 克隆

git clone --recursive https://github.com/mengps/PyHuskarUI.git

• 构建

uv sync
uv run init
uv build pyhuskarui

• 安装

  uv pip install [-e] ./pyhuskarui
  

• 运行 Gallery

uv run ./gallery/main.py

📦 上手

• 创建 QtQuick 应用 QtVersion >= 6.7
• 添加下面的代码到您的 main.py 中

...
from pyhuskarui.husapp import HusApp

if __name__ == "__main__":
    ...
    app = QGuiApplication(sys.argv)
    engine = QQmlApplicationEngine()
    HusApp.initialize(engine)
    ...

• 添加下面的代码到您的 Main.qml 中

 import HuskarUI.Basic
 
 HusWindow { 
   ...
 }

好了，你现在可以愉快的开始使用 PyHuskarUI 了。

🚩 参考

• Ant-d 组件: https://ant-design.antgroup.com/components/overview-cn
• Ant 设计: https://ant-design.antgroup.com/docs/spec/introduce-cn

💓 许可证

使用 Apache License 2.0

🌇 环境

Windows 11 / Ubuntu 24.04.2, Qt Version >= 6.7

🎉 Star 历史