安裝指引：執行環境檢查

根據網路連線狀態與 Docker 支援情況選擇適合的安裝方式。推薦使用 Docker 預建方案，可確保環境一致性並簡化部署流程。若需深度學習功能，請確認 CUDA 支援。

flowchart
    Start[環境準備] --> NetworkCheck{有網路<br/>連線？}
    NetworkCheck -->|有| DockerCheck1{支援<br/>Docker？}
    NetworkCheck -->|無| DockerCheck2{支援<br/>Docker？}
    DockerCheck1 -->|有| DockerPrebuilt[Docker<br/>預建]
    DockerCheck1 -->|無| PyPIInstall[PyPI<br/>安裝]
    DockerCheck2 -->|有| DockerOffline[Docker<br/>離線部署]
    DockerCheck2 -->|無| PackageDownload[套件<br/>預下載]
    
    %% 深度學習支援檢查
    DockerPrebuilt --> DLCheck{使用<br/>深度學習？}
    PyPIInstall --> DLCheck
    DockerOffline --> DLCheck
    PackageDownload --> DLCheck
    
    DLCheck -->|是| CUDACheck[檢查<br/>CUDA 支援]
    DLCheck -->|否| Complete[完成安裝]

    %% 馬卡龍配色
    style Start fill:#B0E0E6,stroke:#87CEEB,stroke-width:2px,color:#333
    style NetworkCheck fill:#E6E6FA,stroke:#DDA0DD,stroke-width:2px,color:#333
    style DockerCheck1 fill:#E6E6FA,stroke:#DDA0DD,stroke-width:2px,color:#333
    style DockerCheck2 fill:#E6E6FA,stroke:#DDA0DD,stroke-width:2px,color:#333
    style DockerPrebuilt fill:#B4E7CE,stroke:#98D8C8,stroke-width:2px,color:#333
    style PyPIInstall fill:#B4E7CE,stroke:#98D8C8,stroke-width:2px,color:#333
    style DockerOffline fill:#B4E7CE,stroke:#98D8C8,stroke-width:2px,color:#333
    style PackageDownload fill:#B4E7CE,stroke:#98D8C8,stroke-width:2px,color:#333
    style DLCheck fill:#FFE4E1,stroke:#FFC0CB,stroke-width:2px,color:#333
    style CUDACheck fill:#B4E7CE,stroke:#98D8C8,stroke-width:2px,color:#333
    style Complete fill:#D3D3D3,stroke:#A9A9A9,stroke-width:2px,color:#333

圖例說明：

• 淡藍色框：流程起點
• 淡紫色框：條件判斷節點
• 淡綠色框：執行操作節點

安裝方式選擇

根據您的環境條件，請選擇適合的安裝方式：

有網路連線的環境

• Docker 預建 - 支援 Docker 的環境（推薦）

  • 無需本地 Python 環境設定
  • 快速部署，環境一致性高

• PyPI 安裝 - 不支援 Docker 的環境

  • 直接安裝到本地 Python 環境
  • 支援多種依賴群組選擇
  • 推薦使用 uv 進行安裝

無網路連線的環境

• Docker 離線部署 - 支援 Docker 的環境

  • 先在有網路環境建置/拉取映像
  • 匯出後傳輸到離線環境使用

• 套件預下載 - 不支援 Docker 的環境

  • 預先下載所有依賴套件
  • 傳輸到離線環境進行安裝

深度學習支援

• 深度學習支援檢測 - 使用深度學習合成器的環境
  • 檢查 NVIDIA GPU 驅動狀態
  • 驗證 PyTorch 與 CUDA 支援
  • 確認系統運算模式（CPU/GPU）

下一步

完成安裝驗證後，您可以：

1. 查看快速入門以獲取詳細使用範例
2. 建立 YAML 設定檔開始使用 PETsARD
3. 探索 PETsARD YAML 文件了解設定方式