Частые вопросы

Potato (Portable Text Annotation Tool) — бесплатный инструмент разметки с открытым исходным кодом для создания качественных датасетов. Он поддерживает разметку текста, изображений, аудио и видео с простой системой конфигурации на YAML.

Да. Potato бесплатен и открыт под лицензией GNU General Public License v3.0 или новее (GPL-3.0-or-later). Вы можете использовать, изменять и распространять его, в том числе коммерчески, при условии что производные работы остаются под GPL. Ранние версии выходили под лицензией PolyForm Shield; на GPL-3.0 Potato перешёл в версии 2.6. Полный текст — в файле LICENSE в репозитории на GitHub.

Программировать не нужно. Potato использует файлы конфигурации в YAML — их легко читать и писать. А в нашей песочнице есть визуальный интерфейс, который собирает конфигурацию без единой строки кода.

Установите через pip: `pip install potato-annotation`. Затем запустите `potato start my_project -c config.yaml`, чтобы поднять сервер разметки. Подробности — в руководстве по быстрому старту.

Potato требует Python 3.7 или выше. Для наилучшей работы рекомендуем Python 3.10 и новее.

Выполните `pip install --upgrade potato-annotation`. Список нововведений смотрите в блоге на /blog. Существующие конфигурации совместимы с новыми версиями — при обновлении минорной версии миграция не нужна.

Potato работает во всех современных браузерах: Chrome, Firefox, Safari и Edge. Для наилучшей работы рекомендуем Chrome или Firefox. Интерфейс разметки адаптивный и работает на планшетах, но для сложных задач лучше десктоп.

Данные остаются на вашей машине. Potato работает полностью локально и никогда не отправляет ваши данные на внешние серверы. Поэтому он подходит для чувствительных данных вроде медицинских записей или закрытых материалов.

Да. Potato разворачивается у вас и работает локально, так что вы полностью контролируете свои данные. Данные не покидают вашу инфраструктуру, что подходит под требования HIPAA, GDPR и других регламентов.

Potato поддерживает разные входные форматы: обычный текст, JSON, JSONL, CSV, TSV, изображения (PNG, JPG, GIF, WebP), аудио (MP3, WAV, OGG) и видеофайлы. Результат можно выгрузить в JSON, JSONL, CSV и специализированные форматы — CoNLL, COCO и датасеты HuggingFace.

Potato поддерживает: радиокнопки (одиночный выбор), флажки (множественный выбор), шкалы Лайкерта, ввод текста, разметку спанов (выделение), ограничивающие рамки, полигоны, попарное сравнение, шкалирование «лучший—худший» и другое. Примеры — в нашей галерее.

Да. Одна задача разметки может включать любое сочетание схем. Например, разметчики могут выделять сущности (разметка спанов), классифицировать тональность (радиокнопки) и оставлять комментарии (ввод текста) — всё это на одном и том же объекте.

Да. Potato поддерживает классификацию изображений радиокнопками и флажками, разметку ограничивающими рамками для детекции объектов и разметку полигонами для задач сегментации.

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

Добавьте в конфигурацию схему разметки спанов с текстом для выделения. Разметчики смогут выделять фрагменты и присваивать им метки. Примеры NER и разметки спанов есть в галерее.

Да. Potato поддерживает свой CSS, свои HTML-шаблоны и настройку макета через YAML. Можно добавить свои шапку, подвал, инструкции и оформление. Подробности — в документации по настройке макета.

Potato поддерживает нескольких разметчиков «из коробки». Каждый входит под своим идентификатором, и его разметка учитывается отдельно. Можно настроить пересечение, чтобы одни и те же объекты размечали несколько человек — для контроля качества.

Да. Potato интегрируется с Prolific и Amazon Mechanical Turk. Разметчики переходят с платформы, выполняют задания в Potato и возвращаются обратно с кодом завершения.

Potato отслеживает, какие объекты размечены несколькими разметчиками. Вы можете выгрузить разметку и посчитать метрики согласованности (каппа Коэна, альфа Криппендорфа и другие) стандартными библиотеками Python.

Да. Можно добавить объекты-проверки внимательности, задать обязательное пересечение разметки и следить за прогрессом разметчиков в админ-панели, чтобы вовремя замечать проблемы.

Типичные причины: 1) убедитесь, что config.yaml — корректный YAML; 2) проверьте, что файл с данными существует и правильно оформлен; 3) убедитесь, что порт (по умолчанию 8000) не занят; 4) посмотрите вывод в терминале — там будут конкретные сообщения об ошибках.

Проверьте, что: 1) вы нажали кнопку сохранения/отправки; 2) каталог вывода доступен для записи; 3) заполнены все обязательные поля. Загляните в консоль браузера — там могут быть ошибки JavaScript.

Удалите файл с его разметкой из каталога вывода. Назначение заданий сформируется заново при следующем входе.

Заходите в наше сообщество в Discord за живой помощью, смотрите GitHub Issues на предмет известных проблем или изучайте документацию. Сообщество дружелюбное и отзывчивое!