Skip to content

安裝

在 macOS、Windows 或 Linux 上通過 pip 安裝 Potato 2.8。涵蓋 Python 版本要求、虛擬環境、vision 擴充套件，以及 2.7.1 及更早版本的使用者為何應當升級。

Potato 可以通過 pip 在幾秒鐘內完成安裝。本指南涵蓋各種安裝方式和環境要求。

從 2.7.1 及更早版本升級

2.7.1 之前的 wheel 包在宣告包資料時只用了一層萬用字元，因此存放在子目錄中的 27 個模板從未被打進發布包。如果你是用 pip 安裝的，solo 模式的初始化路由、管理後臺、評審校準和語料地圖都無法正常工作。從 git 檢出執行不受影響，這也是測試套件一直沒有發現該問題的原因。

2.8.0 版本修復了打包問題。該問題由 @0x6362 在 PR #164 中報告並修復。

bash
pip install --upgrade potato-annotation

系統要求

  • Python：3.8 或更高版本
  • 作業系統：macOS、Linux 或 Windows
  • 記憶體：最低 512MB RAM

通過 pip 安裝

推薦的安裝方式：

bash
pip install potato-annotation

可選擴充套件

預設安裝不會引入任何機器學習依賴。按需新增所需的擴充套件：

bash
pip install 'potato-annotation[ai]'        # LLM 端點
pip install 'potato-annotation[vision]'    # 本地視覺模型
pip install 'potato-annotation[db]'        # 資料庫資料來源
pip install 'potato-annotation[transcribe]'  # 本地轉寫與說話人分離（2.9+）

vision 被刻意排除在 [all] 之外，因為 torch 的安裝體積高達數 GB，而預設使用流程中沒有任何環節需要它。模型權重是單獨的、需要顯式執行的一步：

bash
potato download-models --list
potato download-models mobile_sam

任何權重都不會隨包捆綁，也不會在你未要求的情況下下載。若要在隔離網路環境中安裝，請在聯網的機器上完成下載，再把目錄複製過去。

從原始碼安裝

獲取最新的開發版本：

bash
git clone https://github.com/davidjurgens/potato.git
cd potato
pip install -e .

安裝指定版本

安裝某個特定版本：

bash
pip install potato-annotation==2.9.0

驗證安裝

確認 Potato 已正確安裝：

bash
potato --version

你應當看到類似這樣的輸出：

text
Potato Annotation Tool v2.0.0

升級

升級到最新版本：

bash
pip install --upgrade potato-annotation

可選依賴

若需要額外功能，可安裝對應的可選依賴：

bash
# MySQL 支援
pip install potato-annotation[mysql]
 
# 主動學習
pip install potato-annotation[ml]
 
# 全部可選功能
pip install potato-annotation[all]

疑難排解

許可權錯誤

如果遇到許可權錯誤，可以嘗試：

bash
pip install --user potato-annotation

虛擬環境（推薦）

我們建議使用虛擬環境：

bash
python -m venv potato-env
source potato-env/bin/activate  # Windows 上：potato-env\Scripts\activate
pip install potato-annotation

下一步