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]'        # 数据库数据源

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.8.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

下一步