跳轉到

二、 依賴庫配置

適用人群

本頁面適用於需要了解軟體依賴構成,或現場無法使用軟體內建部署工具的使用者。普通使用者請直接使用軟體內建的"環境部署"模組(推薦)。


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