安装与环境要求

QnBot Python SDK 用于连接 QnBot 设备、管理手套、读取手套姿态与 SDK 处理后的数据，以及控制手套指尖震动。

本文档适用于 qnbot-sdk-glove 1.3.0。安装时只需指定 Glove 版本，pip 会自动解析并安装交付所需的兼容依赖。

环境要求

• Python 3.10 或更高版本
• QnBot VetraSense Glove 或 VetraGlove Nano
• 与当前操作系统和 CPU 架构匹配的 qnbot-sdk-glove wheel
• macOS 14+、glibc Linux 或 Windows

1.3.0 当前提供以下平台的 Glove wheel：

Linux x86_64 和 ARM64 Glove 均要求 glibc 2.34 或更高版本，不支持 musl。

需要更改 SDK 的应用数据目录，或让 CLI 与 SDK 共用同一目录时，见应用数据目录。

安装

macOS

PyPI 当前提供 macOS ARM64 wheel：

python -m pip install "qnbot-sdk-glove==1.3.0"

Linux

PyPI 当前提供 Linux x86_64 和 ARM64 wheel。两种架构都要求 glibc 2.34 或更高版本，不支持 musl Linux：

python -m pip install "qnbot-sdk-glove==1.3.0"

Windows

Windows x86_64 使用 PowerShell：

py -m pip install "qnbot-sdk-glove==1.3.0"

离线安装

从 OTA 下载当前发布的平台离线包。压缩包包含 Core 和 Glove wheel，安装时需要在同一条命令中指定这两个文件：

下载后先解压，再用其中 Core 和 Glove wheel 的实际文件名安装：

python -m pip install "./qnbot_sdk_core-<version>-py3-none-<core-platform-tag>.whl" "./qnbot_sdk_glove-<version>-py3-none-<glove-platform-tag>.whl"

Core 和 Glove 的平台标签可能不同，请使用交付文件的实际名称，不要根据其中一个文件名推断另一个。在 Windows PowerShell 中，将命令开头的 python 替换为 py。

验证安装

验证 Python 依赖和 SDK 导入不需要连接手套，也不需要安装 retargeting 算法包。macOS 和 Linux 运行：

python -m pip check
python -c "from qnbot_sdk import Sdk; from qnbot_sdk.glove import GloveConfig; print('QnBot Python SDK ready')"

Windows PowerShell 运行：

py -m pip check
py -c "from qnbot_sdk import Sdk; from qnbot_sdk.glove import GloveConfig; print('QnBot Python SDK ready')"

预期输出：

No broken requirements found.
QnBot Python SDK ready