跳转至

二、 依赖库配置

适用人群

本页面适用于需要了解软件依赖构成,或现场无法使用软件内置部署工具的用户。普通用户请直接使用软件内置的"环境部署"模块(推荐)。


1. 安装 Python 3.12(必装前置)

本软件推荐使用 Python 3.12 系列 环境。

Ubuntu 24.04.4 LTS 自带 Python 3.12 系列,此系统下可直接跳过本节。

1.1 下载 Python 3.12

建议从 Python 官方网站下载最新的 3.12 稳定版:

python_download.png

1.2 关键安装步骤

1.2.1 启动安装

  1. 运行下载的 .exe 安装程序。
  2. 重点(必选):在安装首界面勾选 "Add Python.exe to PATH"。

    如果不勾选此项,你将无法在终端直接使用 python 命令。

  3. 点击 "Install Now" 或根据需要选择自定义安装。

toPATH.png

1.2.2 禁用路径长度限制(可选)

安装结束时,如果界面出现 "Disable path length limit" 选项,建议点击。这可以避免在处理深度学习模型等深层文件路径时出错。

Disablepathlengthlimit.png

1.3 环境验证

安装完成后,请打开命令行(CMD 或 PowerShell),输入以下命令检查:

# 验证 Python 版本(只要显示 3.12.x 即可)
python --version

2. 核心依赖库

为了支持 YOLO 视觉检测、图像处理及数据分析功能,软件需要配置专用的 Python 依赖库。本软件内置了环境一键部署工具,支持在线和离线两种模式。

2.1 核心依赖库列表

  • OpenCV (opencv-python):图像处理与相机驱动。
  • Pillow (PIL):基础图像操作与格式转换。
  • NumPy:矩阵运算与视觉数据处理。
  • Scikit-learn:算法模型评估与数据预处理。
  • Tqdm:训练及处理过程的进度条显示。

3. 在线部署(推荐)

如果您当前处于有网络连接的环境,这是最快捷的配置方式。

打开软件:进入主界面,选择侧边栏的环境部署。

pythonKU.png

  1. 镜像选择:默认华为云镜像。
  2. 安装:单独点击每一个小卡片并等待进度条结束即可。
  3. 验证:

    # 在终端输入以下命令,出现对应的版本号即可。
    pip list | findstr "opencv pillow numpy scikit-learn tqdm"
    

4. 离线部署(针对生产现场)

针对无法连接互联网的工业现场,请按照以下步骤使用预下载的离线包。

4.1 执行离线安装

  1. 在软件的 "环境部署" 界面中,选择 "离线安装 (Offline Install)"。
  2. 定位资源:在弹出的目录窗口中,选择软件自带的离线包文件夹。

pythonKU2.png

最后一键部署:点击"安装选中文件"。软件将调用内置指令,从本地路径安装 whl 文件,无需联网。

pythonKU3.png