Skip to content

Установка

Как установить Potato через pip на macOS, Windows или Linux: версии Python, виртуальные окружения, необязательные дополнения и обновление с 2.7.1 и более ранних.

Potato устанавливается через pip. На этой странице описаны поддерживаемые версии Python, необязательные дополнения и порядок обновления с 2.7.1 и более ранних версий.

Обновление с 2.7.1 и более ранних версий

Пакеты wheel до 2.7.1 объявляли данные пакета одноуровневым шаблоном glob, поэтому 27 шаблонов, лежащих в подкаталогах, так и не попали в опубликованный пакет. Если вы ставили Potato через pip, у вас не работали маршруты настройки Solo Mode, админ-панель, калибровка судьи и карта корпуса. Запуск из git-checkout это не затрагивало, поэтому набор тестов ошибку так и не поймал.

Версия 2.8.0 исправляет упаковку. Проблему нашёл и исправил в PR #164 @0x6362.

bash
pip install --upgrade potato-annotation

Требования

  • Python: 3.9 или новее
  • Операционная система: macOS, Linux или Windows
  • Память: не меньше 512MB RAM

Установка через pip

Рекомендуемый способ установить Potato:

bash
pip install potato-annotation

Необязательные дополнения

Установка по умолчанию не тянет за собой никакого стека машинного обучения. Добавьте нужные дополнения:

bash
pip install 'potato-annotation[ai]'        # LLM endpoints
pip install 'potato-annotation[vision]'    # local vision models
pip install 'potato-annotation[db]'        # database data sources
pip install 'potato-annotation[mysql]'     # MySQL annotation storage (2.10.2+)
pip install 'potato-annotation[transcribe]'  # local transcription and diarization (2.9+)

vision намеренно не входит в [all], потому что torch занимает несколько гигабайт, а в обычной работе он ни для чего не нужен. Веса моделей скачиваются отдельным явным шагом:

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

Проверка установки

Проверьте, что Potato установлен правильно:

bash
potato --version

Вы увидите версию, а при запуске из checkout ещё и коммит:

text
potato 2.12.1

Обновление

Чтобы обновиться до последней версии:

bash
pip install --upgrade potato-annotation

Необязательные зависимости

Potato 2.12.1 объявляет такие дополнения: ai, formats, viz, preview, mcp, agent, export, huggingface, publish, auth, langchain, fiftyone, s3, gcs, azure, wsi, saml, volumes, db, mysql, deploy, deploy-aws, deploy-openstack, hosting, vision, transcribe и decision. Выберите те, что нужны задаче, или возьмите all:

bash
# Database-backed data sources
pip install 'potato-annotation[db]'
 
# MySQL as the store for annotations (database: {type: mysql})
pip install 'potato-annotation[mysql]'
 
# What a coding agent needs: the MCP server plus browser rendering
pip install 'potato-annotation[agent]'
 
# Most extras. Left out: vision and decision, which pull torch, plus deploy-aws,
# deploy-openstack, fiftyone, s3, gcs, azure, wsi, saml and volumes
pip install 'potato-annotation[all]'

Устранение неполадок

Ошибки прав доступа

Если возникают ошибки прав доступа, попробуйте:

bash
pip install --user potato-annotation

Виртуальное окружение (рекомендуется)

Мы рекомендуем использовать виртуальное окружение:

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

Что дальше