Skip to content

Latest commit

 

History

History
372 lines (253 loc) · 31.3 KB

README_RU.md

File metadata and controls

372 lines (253 loc) · 31.3 KB
Raw
logo

Version

Поддержать проект на Boosty
Поддержать проект

Commit activity Last commit Opened issues Closed issues License

English | Русский

ReActor для Stable Diffusion

Расширение для быстрой и простой замены лиц на любых изображениях. Без фильтра цензуры, 18+, используйте под вашу собственную ответственность

Что нового | Установка | Возможности | Использование | API | Устранение проблем | Обновление | ComfyUI | Ответственность

example

Что нового в последних обновлениях

0.6.0 ALPHA1

  • UI переработан
  • Появилась возможность загружать несколько исходных изображений с лицами или задавать путь к папке, содержащей такие изображения
0.6.0-whatsnew-01 0.6.0-whatsnew-02

0.5.1

  • Теперь можно сохранять модели лиц в качестве файлов "safetensors" (находятся в <sd-web-ui-folder>\models\reactor\faces) и загружать их с ReActor, храня супер легкие модели лиц, которые вы чаще всего используете;
  • Новые опция "Face Mask Correction" - если вы сталкиваетесь с пикселизацией вокруг контуров лица, эта опция будет полезной;
0.5.0-whatsnew-01

Установка

Automatic1111 | Vladmandic SD.Next | Google Colab SD WebUI

Если вы используете AUTOMATIC1111 Web-UI:

  1. (Для пользователей Windows):
  1. Внутри SD Web-UI перейдите во вкладку "Extensions", загрузите список доступных расширений (вкладка "Available") и введите "ReActor" в строке поиска или же вставьте ссылку https://github.com/Gourieff/sd-webui-reactor в "Install from URL" - и нажмите "Install"
  2. Пожалуйста, подождите несколько минут, пока процесс установки полностью не завершится (наберитесь терпения, не прерывайте процесс)
  3. Проверьте последнее сообщение в консоли SD-WebUI:
  • Если вы видите "--- PLEASE, RESTART the Server! ---" - остановите Сервер (CTRL+C или CMD+C) и запустите его заново - ИЛИ же перейдите во вкладку "Installed", нажмите "Apply and restart UI"
  • Если вы видите "Done!", просто перезагрузите UI, нажав на "Reload UI"
  1. Готово!

Если вы используете SD.Next:

  1. Закройте (остановите) SD WebUI Сервер, если он запущен
  2. (Для пользователей Windows) Смотрите Шаг 1 для Automatic1111 (если же вы следовали данным шагам (пункт VIII) вместо этого - переходите к Шагу 5)
  3. Перейдите в (Windows)automatic\venv\Scripts или (MacOS/Linux)automatic/venv/bin, запустите Терминал или Консоль (cmd) для данной папки и выполните activate
  4. Выполните pip install insightface==0.7.3
  5. Запустите SD.Next, перейдите во вкладку "Extensions", вставьте эту ссылку https://github.com/Gourieff/sd-webui-reactor в "Install from URL" и нажмите "Install"
  6. Пожалуйста, подождите несколько минут, пока процесс установки полностью не завершится (наберитесь терпения, не прерывайте процесс)
  7. Проверьте последнее сообщение в консоли SD.Next:
  • Если вы видите "--- PLEASE, RESTART the Server! ---" - остановите Сервер (CTRL+C или CMD+C) или просто закройте консоль
  1. Перейдите в директорию automatic\extensions\sd-webui-reactor - если вы видите там папку models\insightface с файлом inswapper_128.onnx внутри, переместите его в папку automatic\models\insightface
  2. Готово, можете запустить SD.Next WebUI!

Если вы используете Cagliostro Colab UI:

  1. В активном WebUI перейдите во вкладку "Extensions", загрузите список доступных расширений (вкладка "Available") и введите "ReActor" в строке поиска или же вставьте ссылку https://github.com/Gourieff/sd-webui-reactor в "Install from URL" - и нажмите "Install"
  2. Пожалуйста, подождите некоторое время, пока процесс установки полностью не завершится (наберитесь терпения, не прерывайте процесс)
  3. Когда вы увидите сообщение "--- PLEASE, RESTART the Server! ---" (в секции "Start UI" вашего ноутбука "Start Cagliostro Colab UI") - перейдите во вкладку "Installed" и нажмите "Apply and restart UI"
  4. Готово!

Возможности

  • Быстрая и точна замена лиц (faceswap) на изображении
  • Поддержка нескольких лиц
  • Определение пола
  • Функция сохранения оригинального изображения (сгенерированного до замены лица)
  • Восстановление лица после замены
  • Увеличение размера полученного изображения
  • Сохранение и загрузка Моделей Лиц типа Safetensors
  • Коррекция Маски Лица для предотвращения какой-либо пикселизации вокруг контуров лиц
  • Возможность задать порядок постобработки
  • 100% совместимость с разными SD WebUI: Automatic1111, SD.Next, Cagliostro Colab UI
  • Отличная производительность даже с использованием ЦПУ, ReActor для SD WebUI абсолютно не требователен к мощности вашей видеокарты
  • Поддержка CUDA, начиная с версии 0.5.0
  • Поддержка API: как встроенного в SD WebUI, так и внешнего (через POST/GET запросы)
  • Поддержка ComfyUI
  • Поддержка компьютеров Mac M1/M2
  • Регулировка уровня логов консоли
  • Без NSFW фильтров (данное расширение адресовано высокоразвитым интеллектуальным людям, а не извращенцам; наше общество должно быть ориентировано на своём пути на высшие стандарты, а не на низшие - в этом состоит суть развития и эволюции человеческого общества; поэтому, моя позиция такова - что зрелые умом люди достаточно разумны, чтобы понимать, что есть хорошо, а что плохо и нести полную ответственность за собственные действия; для прочих - никакие "фильтры" не помогут, пока эти люди сами не поймут, как работает Вселенная)

Использование

Используя данное программное обеспечение, вы соглашаетесь с ответственностью

  1. В раскрывающимся меню "ReActor" импортируйте изображение, содержащее лицо;
  2. Установите флажок "Enable";
  3. Готово, теперь результат будет иметь то лицо, которое вы выбрали.

example

Индексы Лиц (Face Indexes)

ReActor определяет лица на изображении в следующей последовательности:
слева-направо, сверху-вниз.

Если вам нужно заменить определенное лицо, вы можете указать индекс для исходного (source, с лицом) и входного (input, где будет замена лица) изображений.

Индекс первого обнаруженного лица - 0.

Вы можете задать индексы в том порядке, который вам нужен.
Например: 0,1,2 (для Source); 1,0,2 (для Input).
Это означает, что: второе лицо из Input (индекс = 1) будет заменено первым лицом из Source (индекс = 0) и так далее.

Определение Пола

Вы можете обозначить, какой пол нужно определять на изображении.
ReActor заменит только то лицо, которое удовлетворяет заданному условию.

Если лицо получилось нечётким

Используйте опцию "Restore Face". Также можете попробовать опцию "Upscaler". Для более точного контроля параметров используйте Upscaler во вкладке "Extras". Также вы можете установить порядок постобработки (начиная с версии 0.1.0): example

Прежняя логика была противоположенной (Upscale -> затем Restore), что приводило к более худшему качеству изображения лица (а также к значительной разнице текстур) после увеличения.

Результат имеет несколько лиц

Выберите номера лиц, которые нужно поменять, используя поля "Comma separated face number(s)" для исходного изображения лица и для результата. Можно устанавливать любой, необходимый вам, порядок лиц. example

Результат получился чёрным

Это значит, что сработал NSFW фильтр.

IamSFW

Img2Img

Используйте эту вкладку, чтобы заменить лицо на уже готовом изображении (флажок "Swap in source image") или на сгенерированном на основе готового (флажок "Swap in generated image").

Inpainting также работает, но замена лица происходит только в области маски.
Пожалуйста, используйте с опцией "Only masked" для "Inpaint area", если вы применяете "Upscaler". Иначе, используйте функцию увеличения (апскейла) через вкладку "Extras" или через опциональный загрузчик "Script" (внизу экрана), применив "SD upscale" или "Ultimate SD upscale".

Extras

Начиная с версии 0.5.0, вы можете использовать ReActor через вкладку Extras, что даёт очень быструю производительность и возможность замены лиц в обход пайплайна SD, что иногда вызывает размытие или искажение деталей оригинального изображения

IamSFW

API

Вы можете использовать ReActor как со встроенным SD Webui API так и через внешнее API.

Подробная инструкция здесь.

Устранение проблем

I. "You should at least have one model in models directory"

Проверьте путь, где хранится модель "inswapper_128.onnx". Файл должен находиться в папке stable-diffusion-webui\models\insightface. Переместите модель туда, если она находится в какой-то иной директории.

II. Какие-либо проблемы с установкой Insightface или прочих пакетов

(Для пользователей Mac M1/M2) Если вы получаете ошибки в ходе установки Insightface - читайте Gourieff#42

(Для пользователей Windows) Если VS C++ Build Tools или MS VS 2022 установлены но вы видите ошибки, связанные с отсутствием Insightface, попробуйте следующее:

  1. Закройте (остановите) SD WebUI Сервер и запустите его снова (возможно, не прошла инициализация пакета после его установки)

(Для пользователей любых ОС) Попробуйте следующее:

  1. Закройте (остановите) SD WebUI Сервер, если он запущен
  2. Перейдите в папку (Windows)venv\Lib\site-packages или (MacOS/Linux)venv/lib/python3.10/site-packages
  3. Если вы видите к-л папки с именами, начинающимися с ~ (например, "~rotobuf") - удалите их
  4. Перейдите в (Windows)venv\Scripts или (MacOS/Linux)venv/bin
  5. Откройте Терминал или Консоль (cmd) для этой папки и выполните activate
  6. Для начала обновите pip: pip install -U pip
  7. Далее:
    • pip install insightface==0.7.3
    • pip install onnx
    • pip install "onnxruntime-gpu>=1.16.1"
    • pip install opencv-python
    • pip install tqdm
  8. Выполните deactivate, закройте Терминал или Консоль и запустите SD WebUI, ReActor должен запуститься без к-л проблем - если же нет, добро пожаловать в раздел "Issues".

III. "TypeError: UpscaleOptions.init() got an unexpected keyword argument 'do_restore_first'"

Для начала отключите любые другие Roop-подобные расширения:

  • Перейдите в 'Extensions -> Installed' и снимите флажок с ненужных: uncompatible-with-other-roop
  • Нажмите 'Apply and restart UI'

Альтернативные решения:

IV. "AttributeError: 'FaceSwapScript' object has no attribute 'enable'"

Отключите расширение "SD-CN-Animation" (или какое-либо другое, вызывающее конфликт)

V. "INVALID_PROTOBUF : Load model from <...>\models\insightface\inswapper_128.onnx failed:Protobuf parsing failed" ИЛИ "AttributeError: 'NoneType' object has no attribute 'get'" ИЛИ "AttributeError: 'FaceSwapScript' object has no attribute 'save_original'"

Эта ошибка появляется, если что-то не так с файлом модели inswapper_128.onnx.

Скачайте вручную по ссылке here и сохраните в директорию stable-diffusion-webui\models\insightface, заменив имеющийся файл.

VI. "ValueError: This ORT build has ['TensorrtExecutionProvider', 'CUDAExecutionProvider', 'CPUExecutionProvider'] enabled" ИЛИ "ValueError: This ORT build has ['AzureExecutionProvider', 'CPUExecutionProvider'] enabled"

  1. Закройте (остановите) SD WebUI Сервер, если он запущен
  2. Перейдите в (Windows)venv\Lib\site-packages или (MacOS/Linux)venv/lib/python3.10/site-packages и посмотрите, если там папки с именам, начинающимися на "~" (например, "~rotobuf"), удалите их
  3. Перейдите в (Windows)venv\Scripts или (MacOS/Linux)venv/bin, откройте Терминал или Консоль (cmd) и выполните activate
  4. Затем:
  • python -m pip install -U pip
  • pip uninstall -y onnxruntime onnxruntime-gpu onnxruntime-silicon onnxruntime-extensions
  • pip install "onnxruntime-gpu>=1.16.1"

Если это не помогло - значит какое-то другое расширение переустанавливает onnxruntime всякий раз, когда SD WebUI проверяет требования пакетов. Внимательно посмотрите список активных расширений. Некоторые расширения могут вызывать переустановку onnxruntime-gpu на версию onnxruntime<1.16.1 при каждом запуске SD WebUI.
ORT 1.16.0 выкатили с ошибкой microsoft/onnxruntime#17631 - не устанавливайте её!

VII. "ImportError: cannot import name 'builder' from 'google.protobuf.internal'"

  1. Закройте (остановите) SD WebUI Сервер, если он запущен
  2. Перейдите в (Windows)venv\Lib\site-packages или (MacOS/Linux)venv/lib/python3.10/site-packages и посмотрите, если там папки с именам, начинающимися на "~" (например, "~rotobuf"), удалите их
  3. Перейдите в папку "google" (внутри "site-packages") и удалите любые папки с именам, начинающимися на "~"
  4. Перейдите в (Windows)venv\Scripts или (MacOS/Linux)venv/bin, откройте Терминал или Консоль (cmd) и выполните activate
  5. Затем:
  • python -m pip install -U pip
  • pip uninstall protobuf
  • pip install "protobuf>=3.20.3"

Если это не помгло - значит, есть к-л другое расширение, которое использует неподходящую версию пакета protobuf, и SD WebUI устанавливает эту версию при каждом запуске.

VIII. (Для пользователей Windows) Если вы до сих пор не можете установить пакет Insightface по каким-то причинам или же просто не желаете устанавливать Visual Studio или VS C++ Build Tools - сделайте следующее:

  1. Закройте (остановите) SD WebUI Сервер, если он запущен
  2. Скачайте готовый пакет Insightface и сохраните его в корневую директорию stable-diffusion-webui (или SD.Next) - туда, где лежит файл "webui-user.bat" или (A1111 Portable) "run.bat"
  3. Из корневой директории откройте Консоль (CMD) и выполните .\venv\Scripts\activate
    ИЛИ
    (A1111 Portable) Откройте Консоль (CMD)
  4. Обновите PIP: python -m pip install -U pip
    ИЛИ
    (A1111 Portable)system\python\python.exe -m pip install -U pip
  5. Затем установите Insightface: pip install insightface-0.7.3-cp310-cp310-win_amd64.whl
    ИЛИ
    (A1111 Portable)system\python\python.exe -m pip install insightface-0.7.3-cp310-cp310-win_amd64.whl
  6. Готово!

IX. Ошибка обновления 07-Август-23

Если после очередного git pull вы получили сообщение: Merge made by the 'recursive' strategy и затем, когда проверяете статус репозитория через git status, вы видите Your branch is ahead of 'origin/main' by

Выполните следующее:

Внутри папки extensions\sd-webui-reactor запустите Терминал или Консоль (cmd) и затем:

  • git reset f48bdf1 --hard
  • git pull

ИЛИ:

Полностью удалите папку sd-webui-reactor внутри директории extensions, запустите Терминал или Консоль (cmd) и выполните git clone https://github.com/Gourieff/sd-webui-reactor

X. Ошибки установки в StabilityMatrix

Если вы столкнулись с ошибками при установки данного расширения в пакетном менеджере StabilityMatrix - изучите информацию по ссылке: Gourieff#129 (comment)

Обновление

Самый простой и удобный способ обновления SD WebUI и расширений: https://github.com/Gourieff/sd-webui-extensions-updater

ComfyUI

Вы можете использовать ReActor с ComfyUI
Инструкция здесь: ReActor Node

Ответственность

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

Разработчики этого программного обеспечения осведомлены о возможных неэтичных применениях и обязуются принять против этого превентивные меры. Мы продолжим развивать этот проект в позитивном направлении, придерживаясь закона и этики.

Подразумевается, что пользователи этого программного обеспечения будут использовать его ответственно, соблюдая локальное законодательство. Если используется лицо реального человека, пользователь обязан получить согласие заинтересованного лица и четко указать, что это дипфейк при размещении контента в Интернете. Разработчики и Со-авторы данного программного обеспечения не несут ответственности за действия конечных пользователей.

Используя данное расширение, вы соглашаетесь не создавать материалы, которые:

  • нарушают какие-либо действующие законы тех или иных государств или международных организаций;
  • причиняют какой-либо вред человеку или лицам;
  • пропагандируют любую информацию (как общедоступную, так и личную) или изображения (как общедоступные, так и личные), которые могут быть направлены на причинение вреда;
  • используются для распространения дезинформации;
  • нацелены на уязвимые группы людей.

Данное программное обеспечение использует предварительно обученные модели buffalo_l и inswapper_128.onnx, представленные разработчиками InsightFace. Эти модели распространяются при следующих условиях:

Перевод из текста лицензии insighface: Предварительно обученные модели InsightFace доступны только для некоммерческих исследовательских целей. Сюда входят как модели с автоматической загрузкой, так и модели, загруженные вручную.

Пользователи данного программного обеспечения должны строго соблюдать данные условия использования. Разработчики и Со-авторы данного программного продукта не несут ответственности за неправильное использование предварительно обученных моделей InsightFace.

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

Хэш файлов моделей

Безопасные для использования модели имеют следующий хэш:

inswapper_128.onnx

MD5:a3a155b90354160350efd66fed6b3d80
SHA256:e4a3f08c753cb72d04e10aa0f7dbe3deebbf39567d4ead6dce08e98aa49e16af

1k3d68.onnx

MD5:6fb94fcdb0055e3638bf9158e6a108f4
SHA256:df5c06b8a0c12e422b2ed8947b8869faa4105387f199c477af038aa01f9a45cc

2d106det.onnx

MD5:a3613ef9eb3662b4ef88eb90db1fcf26
SHA256:f001b856447c413801ef5c42091ed0cd516fcd21f2d6b79635b1e733a7109dbf

det_10g.onnx

MD5:4c10eef5c9e168357a16fdd580fa8371
SHA256:5838f7fe053675b1c7a08b633df49e7af5495cee0493c7dcf6697200b85b5b91

genderage.onnx

MD5:81c77ba87ab38163b0dec6b26f8e2af2
SHA256:4fde69b1c810857b88c64a335084f1c3fe8f01246c9a191b48c7bb756d6652fb

w600k_r50.onnx

MD5:80248d427976241cbd1343889ed132b3
SHA256:4c06341c33c2ca1f86781dab0e829f88ad5b64be9fba56e56bc9ebdefc619e43

Пожалуйста, сравните хэш, если вы скачиваете данные модели из непроверенных источников