截至 2026 年 9 月 7 日,DeepLabCut 官方發布記錄已列出 3.0.1;官方安裝文件同時確認 macOS 可安裝,但 MPS 只適用於部分模型與操作,不能當作 CUDA 的完整替代。查看 DeepLabCut 版本發布記錄 因此,本週最穩妥的動作是:先在 Mac 上完成 GUI 標註、CPU 推理與小樣本驗證;若你的研究依賴特定模型或高負載訓練,就保留 Linux NVIDIA GPU,必要時採用雙軌環境。
最後更新於 2026 年 9 月 7 日;版本與平台資料核實自 DeepLabCut 官方發布記錄、安裝文件、PyTorch 設定文件及 napari 使用說明。
這篇文章適合三類讀者:第一次做動物姿態估計、需要低門檻 GUI 環境的研究生;正在維護 DeepLabCut 2.x 專案、擔心 PyTorch 遷移破壞既有結果的科研人員;以及實驗室沒有 Mac 或 NVIDIA GPU、需要先驗證遠端環境的技術負責人。
SECTION 01 先用任務分流,別把「能啟動」當成「能完成研究」
DeepLabCut 3.0.1 Mac 安裝的第一個判斷,不是看介面能否開啟,而是看你的任務是否需要 CUDA、特定模型運算或長時間訓練。3.x 已採 PyTorch-first 路線,官方仍保留既有標註資料的遷移能力;這讓 Mac 適合做工作流驗證,但不代表每種模型都能在 Apple GPU 上順利執行。
| 你的主要任務 | Mac 路線 | 主要風險 | 建議結論 |
|---|---|---|---|
| GUI 建專案、抽幀與人工標註 | 遠端或本地 Mac | 遠端桌面操作延遲、影片讀取問題 | 可優先採用 Mac |
| CPU 小樣本推理 | macOS + PyTorch CPU | 執行時間較長,需控制樣本規模 | 適合先做可行性驗收 |
| MPS 模型驗證 | Apple Silicon + PyTorch MPS | 模型或算子可能回退、報錯或輸出不完整 | 逐模型測試,不可直接承諾加速 |
| 高負載模型訓練 | Linux + NVIDIA GPU | 需要額外主機、權限與環境管理 | 保留 Linux GPU |
| 既有 2.x 專案維護 | 舊環境與新 PyTorch 環境並存 | 直接升級可能影響重現結果 | 雙環境回歸後再遷移 |
對於「沒有 NVIDIA GPU 怎麼跑 DeepLabCut」這類需求,答案不是只能放棄,而是先縮小驗證範圍:用 Mac 完成標註和推理原型,再根據模型結果決定是否把訓練交給 Linux GPU。
SECTION 02 第一步:新手先建立隔離的 PyTorch 環境
官方安裝文件列出不同安裝方式與可選元件;你不需要一開始就把完整實驗室資料搬進去。先使用一段已脫敏、解析度和格式接近正式資料的短影片,目標是確認環境、GUI 和檔案結構都能正常運作。參考 DeepLabCut 官方安裝文件
下面只保留建立環境、安裝、版本檢查和啟動所需的最小流程。具體 Python 版本及套件要求,應以官方文件當下列出的受支援範圍為準,不要照抄舊教學中的固定版本。
conda create -n dlc301 python
conda activate dlc301
python -m pip install deeplabcut
python -c "import deeplabcut; print(deeplabcut.__version__)"
python -m deeplabcut
如果你的安裝方式需要 GUI 額外元件,按照官方安裝頁選擇對應的 GUI 選項;Model Zoo 也應視研究模型需要再加入,而不是把所有可選套件一次裝入。安裝完成後,先確認三件事:
deeplabcut.__version__回報的版本是否為你預期的 3.0.1。- GUI 能否建立測試專案,而不是只在終端機成功 import。
- 專案資料夾能否在重新啟動後再次開啟。
用最小專案驗證檔案流
先建立測試專案,再從脫敏影片抽取少量影格,接著在 napari-deeplabcut 中開啟標註介面。不要直接使用唯一一份原始影片,也不要讓測試輸出覆蓋正式專案。
你需要保留:
- 原始影片的唯讀副本;
- 測試專案與正式專案分開的資料夾;
- 建專案後產生的設定檔、標註檔和分析輸出;
- 一份記錄模型名稱、裝置、錯誤訊息及推理結果的文字檔。
napari-deeplabcut 並不是單純的影片播放器,它依賴專案設定、標註資料位置和既定的目錄結構。開啟介面後若看得到影片,卻找不到標註或無法保存,不應把問題歸咎於滑鼠操作;先回到專案路徑與設定檔檢查。依照官方 napari-deeplabcut 基本操作說明驗證
提醒: GUI 啟動成功只代表依賴大致可載入,不代表影片分析閉環已通過。至少要完成「標註可保存、專案可重新開啟、同一段脫敏影片可再次分析」三項檢查,才值得把正式資料搬入。
SECTION 03 第二步:先驗收標註與分析閉環,再談 MPS
行為科學研究的失敗點經常不在安裝,而在影片格式、關鍵點定義、專案目錄和輸出檔案之間沒有接起來。你可以按照以下里程碑執行:
| 驗收里程碑 | 最小動作 | 通過標準 | 未通過時的處理 |
|---|---|---|---|
| 影片讀取 | 載入一段脫敏代表性影片 | 影格順序與畫面內容可核對 | 先檢查格式、編碼與路徑 |
| 專案建立 | 建立測試專案並抽取影格 | 設定檔與影格位於預期資料夾 | 不要匯入正式資料,先修正路徑 |
| 關鍵點標註 | 標註少量影格並儲存 | 關閉後重新開啟仍可看到標註 | 檢查檔案權限與標註位置 |
| 推理輸出 | 使用固定模型分析同一影片 | 輸出檔案完整且可被下游工具讀取 | 改用 CPU 小樣本,記錄錯誤 |
| 重現檢查 | 重新連線後再次開啟專案 | 能找到相同專案與結果 | 檢查遠端磁碟、權限與程序狀態 |
這個驗收流程也適合沒有本地 Mac 的實驗室:先在遠端 Mac 上完成 napari 互動,再用 SSH 執行不需要持續操作 GUI 的長任務。圖形介面的連線品質與主機的模型運算能力必須分開記錄,否則網路延遲很容易被誤判成硬體速度問題。
SECTION 04 第三步:MPS 是否可用,要按模型與操作逐項確認
PyTorch 的 MPS 後端可讓部分運算使用 Apple GPU,但官方 MPS 說明並沒有把它描述成 CUDA 的等價替代;DeepLabCut 的 PyTorch 設定文件也要求你按照實際模型和裝置狀況配置。查看 PyTorch MPS 後端說明 查看 DeepLabCut PyTorch 裝置設定
你應該在每次模型驗證中記錄以下欄位:
| 記錄欄位 | 要回答的問題 | 為何不能省略 |
|---|---|---|
| 模型名稱與版本 | 實際使用哪個模型? | 不同模型的運算需求可能不同 |
| 裝置識別結果 | 使用 CPU、MPS,還是其他後端? | PyTorch 能看到 MPS 不等於任務必然使用 MPS |
| 是否發生回退 | 某些操作是否退回 CPU? | 回退可能改變執行時間和穩定性 |
| 輸出完整性 | 關鍵點、置信度與檔案是否完整? | 能跑完不代表結果可用 |
| 可重現性 | 同一影片重跑是否能核對? | 研究結果需要可追溯,不只看一次成功 |
在 DeepLabCut Model Zoo 中先核對目標模型的說明,再進行小樣本測試;不要因為 MPS 裝置被 PyTorch 識別,就推論所有模型都能加速。查看官方 Model Zoo 說明 若出現未支援操作、錯誤或結果不完整,停止擴大訓練,退回 CPU 小樣本驗證,或把訓練交給 Linux NVIDIA GPU。PyTorch 亦提供 MPS 環境變數說明,但這些設定是除錯或行為調整工具,不是模型相容性的保證。查看 PyTorch MPS 環境變數文件
SECTION 05 舊 2.x 專案怎樣遷移才不破壞既有結果?
3.x 可以延續既有標註資料,但「資料可遷移」與「結果可直接等同」是兩件事。若你正在維護論文、在研實驗或已經發表的分析流程,應把舊 TensorFlow 環境保留成唯讀參考,另建 PyTorch 環境,不要直接在原環境上升級。
建議用同一個固定資料切分做回歸:
- 核對關鍵點名稱、順序和身體部位定義。
- 核對專案設定檔、影片路徑和影格選擇方式。
- 在新環境執行小規模推理,保存原始輸出。
- 對比關鍵點座標、置信度與缺失值處理。
- 檢查下游統計、行為分類或圖表程式是否仍能讀取結果。
- 在回歸完成前,不要刪除舊環境,也不要覆蓋原始模型和輸出。
這裡不應作出脫離資料集的準確度或速度承諾;你真正要確認的是既有科學問題所需的輸入、推理輸出和下游分析仍然可用。
SECTION 06 遠端 Mac、Linux GPU,還是雙軌環境?
| 決策維度 | 遠端 Apple Silicon Mac | Linux NVIDIA GPU | Mac + Linux 雙軌 |
|---|---|---|---|
| GUI 標註 | 適合,需驗收遠端桌面 | 可行,但圖形桌面配置較依賴管理 | Mac 負責互動,Linux 負責訓練 |
| CPU 推理 | 可行,適合原型與小樣本 | 可行 | 依任務分配 |
| MPS 驗證 | 可嘗試,但按模型判斷 | 不使用 MPS | Mac 做相容性測試 |
| CUDA 依賴 | 不符合 | 適合 | Linux 保留主力 |
| 既有流程遷移 | 適合建立新環境 | 適合延續 GPU 工作流 | 舊流程與新流程分開回歸 |
| 適合的使用週期 | 短期驗證、GUI 標註、教學 | 持續訓練與高負載任務 | 需要兼顧研究與相容性 |
如果只是要確認 DeepLabCut GUI、napari 標註和一段代表性影片的推理流程,遠端 Mac 能降低購買實機的前置成本;如果研究的核心是長時間訓練、CUDA 專用操作或大量模型實驗,Mac 不應取代 Linux GPU。若兩種需求同時存在,雙軌通常比強迫單一平台承擔所有工作更容易維持重現性。
沒有 Mac 的實驗室可以先查看 VPSNIX 的遠端 Mac 方案,再以短週期環境完成安裝、GUI、MPS 識別和代表性影片驗收。選擇時不要只比較月費,還要確認遠端桌面方式、SSH、資料下載、資料夾權限,以及斷線後程序能否繼續。
SECTION 07 交付前的課題組驗收清單
在讓其他研究成員使用之前,管理者應完成以下檢查:
- 以同一段脫敏影片完成建專案、抽幀、標註、保存和重新開啟。
- 在遠端桌面中確認 napari 操作不會因權限或顯示環境而失效。
- 透過 SSH 執行一個可記錄的推理任務,確認斷線後程序狀態仍可查詢。
- 檢查研究成員對專案資料夾具有必要權限,但原始影片和基準結果不會被任意覆蓋。
- 重新連線後找到相同專案、模型和輸出,並完成成果下載。
- 將模型名稱、裝置識別、回退情況和錯誤訊息寫入交付記錄。
若實驗室正在比較購買與租用,可先參考 VPSNIX 的方案與計費頁面,但不要只根據安裝是否成功作長期投入決定;真正有價值的是代表性任務能否完整走完,而且結果可以由另一位成員重新檢查。
SECTION 08 常見問題
DeepLabCut 3.0.1 支援 Apple Silicon 嗎?
支援 macOS 安裝,但 Apple Silicon 的實際 GPU 使用仍要按 PyTorch 後端、模型和操作驗證。你可以先以遠端 Mac 完成 GUI 標註、CPU 推理和小樣本測試;若 MPS 出現不支援運算或結果異常,就應停止擴大任務,改用 CPU 或 Linux GPU。
DeepLabCut 在 Mac 上能用 MPS 訓練嗎?
可以嘗試,但不能把 PyTorch MPS 視為完整 CUDA 替代。部分模型或操作可能無法使用 MPS、出現回退,甚至需要改用 CPU。每次測試都要記錄裝置識別、模型名稱、回退狀態和輸出完整性,只有通過資料回歸後,才適合考慮擴大訓練。
DeepLabCut 3.0 還需要 TensorFlow 嗎?
新專案應優先考慮 PyTorch 路線,但舊 TensorFlow 專案不應直接刪除。既有標註資料具備遷移可能,然而模型輸出和下游分析仍需逐項回歸。對正在支援論文或在研實驗的環境,保留舊環境直到新流程通過固定資料切分的核對更安全。
沒有 NVIDIA GPU 怎樣執行 DeepLabCut?
沒有 NVIDIA GPU 時,Mac 仍可用於專案建立、影片標註、CPU 推理和相容性驗證;部分模型可再嘗試 MPS。若目標任務需要大量訓練、CUDA 專用功能或穩定重現既有 GPU 結果,應使用 Linux NVIDIA GPU,或讓 Mac 與 Linux 分別負責互動和訓練。
實驗室沒有 Mac 怎樣驗證 DeepLabCut GUI?
你可以租用遠端 Mac,建立隔離 Python 環境,透過遠端桌面啟動 napari-deeplabcut,再用一段脫敏影片完成標註和推理。驗收不能只看畫面是否出現,還要檢查專案重開、SSH 長任務、斷線後程序、資料權限及成果下載,最後才決定是否長期部署。
如果你目前的方案是直接在 Windows 上找替代介面、依賴實驗室共用 Linux 主機,常見問題是沒有 macOS GUI、排程與權限受他人限制,以及無法快速重現 Apple Silicon 的相容性;若改用虛擬化或臨時改環境,圖形互動與裝置後端又未必符合正式工作流。對需要短期完成 DeepLabCut 3.0.1 標註、MPS 識別和代表性影片推理的人,先租用 VPSNIX 的遠端 Mac 走完閉環,通常比只憑安裝畫面購買設備更容易控制風險;但若你要長期進行高負載訓練或必須使用 CUDA,仍應把 Linux NVIDIA GPU 保留為主力。