Если после установки ReActor в Stable Diffusion вкладка расширения не появляется, а в консоли видна ошибка вида ModuleNotFoundError: No module named 'insightface', причина почти всегда одна — не установились зависимости, без которых расширение физически не запускается. Это самая частая проблема при подключении sd-webui-reactor к AUTOMATIC1111 WebUI, и она решается за несколько минут, если знать правильный порядок действий.
ReActor — это расширение для замены лиц на сгенерированных изображениях, форк популярного, но заброшенного проекта Roop. Ниже разберём системные требования, два способа установки, типичные ошибки и базовую настройку после запуска.
Системные требования перед установкой
Перед тем как ставить расширение, убедитесь, что окружение подготовлено. ReActor требователен не столько к видеокарте, сколько к версии Python и наличию дополнительных библиотек. Расширение рассчитано на работу внутри AUTOMATIC1111 Stable Diffusion WebUI — в других интерфейсах, например в ComfyUI, используется отдельная реализация с другой процедурой установки.
- 🐍 Python 3.10 — версия, под которую собран стандартный WebUI; на других версиях зависимости могут не собраться.
- 🧩 Установленный и рабочий AUTOMATIC1111 WebUI, который запускается без ошибок.
- 💾 Свободное место на диске для моделей распознавания и замены лиц — они скачиваются при первом использовании.
- 🌐 Доступ в интернет при первом запуске — расширение подтягивает веса моделей автоматически.
- 🛠️ Для Windows желательно наличие Visual Studio Build Tools — без них компиляция некоторых пакетов может завершиться ошибкой.
⚠️ Внимание: если WebUI установлен в папке с кириллицей в пути или требует прав администратора, установка зависимостей может молча обрываться. Проверьте, что путь к папке stable-diffusion-webui содержит только латинские символы.
Способ 1: установка через вкладку Extensions
Самый простой путь — встроенный установщик WebUI. Он подходит большинству пользователей и не требует работы с командной строкой.
Запустите WebUI и откройте вкладку Extensions. Перейдите в подраздел Install from URL, вставьте в поле адрес репозитория расширения и нажмите Install:
https://github.com/Gourieff/sd-webui-reactorПосле завершения загрузки перейдите в подраздел Installed и нажмите Apply and restart UI. Веб-интерфейс перезапустится, и при удачной установке в нижней части вкладок txt2img и img2img появится выпадающая панель ReActor.
☑️ Проверка после установки ReActor
Способ 2: ручная установка через Git
Если установка через интерфейс зависает или обрывается, надёжнее склонировать репозиторий вручную. Откройте терминал в папке extensions внутри каталога WebUI и выполните:
git clone https://github.com/Gourieff/sd-webui-reactor.gitДалее необходимо установить зависимости в то же окружение Python, которое использует WebUI. Для стандартной установки на Windows это виртуальное окружение venv в корне проекта. Активируйте его и поставьте пакеты:
venv\Scripts\activate
pip install insightface onnxruntime
⚠️ Внимание: устанавливать пакеты нужно именно в окружение WebUI, а не в системный Python. Если поставитьinsightfaceглобально, расширение его не увидит, и ошибкаModuleNotFoundErrorостанется.
После этого полностью закройте консоль WebUI и запустите webui-user.bat заново — простой перезагрузки интерфейса из браузера бывает недостаточно, так как часть библиотек подгружается только при старте сервера.
Типичные ошибки и их решение
Значительная часть проблем при установке ReActor сводится к нескольким повторяющимся сценариям. Ниже — таблица с симптомами и проверяемыми решениями.
| Симптом | Вероятная причина | Что проверить |
|---|---|---|
| Нет вкладки ReActor | Расширение не загрузилось при старте | Лог консоли при запуске WebUI |
| ModuleNotFoundError: insightface | Зависимости в другом окружении | Установку пакетов в venv проекта |
| Ошибка компиляции пакетов на Windows | Отсутствуют Build Tools | Наличие Visual Studio Build Tools |
| Генерация идёт, но лицо не меняется | Чекбокс Enable не активирован | Галочку Enable в панели ReActor |
| Ошибка загрузки моделей | Обрыв скачивания при первом запуске | Содержимое папки models/reactor |
Если ни один из пунктов не помог, откройте консоль, из которой запускается WebUI, и найдите первое по порядку сообщение об ошибке — именно оно указывает на источник сбоя, а последующие ошибки часто являются его следствием.
Что делать, если insightface не устанавливается
Иногда pip не может собрать пакет из исходников. В этом случае попробуйте установить готовую сборку (wheel) под вашу версию Python из неофициальных репозиториев сборок, либо обновите pip и setuptools командой pip install --upgrade pip setuptools, после чего повторите установку.
Первый запуск и базовая настройка
После успешной установки работа с расширением начинается с панели ReActor внутри вкладки txt2img или img2img. Раскройте её, поставьте галочку Enable и загрузите исходное фото лица в поле загрузки изображения. Без активированного чекбокса Enable расширение полностью игнорируется, даже если фото загружено — это самая частая причина «неработающей» замены.
Сгенерируйте изображение как обычно. При первом запуске ReActor скачает необходимые модели — это может занять время и выглядеть как зависание. Дождитесь окончания загрузки в консоли.
- 🎛️ Restore Face — опция постобработки лица для повышения чёткости после замены.
- 🔢 Faces Index — выбор конкретного лица на изображении, если их несколько.
- ⚖️ Weight — степень влияния исходного лица на результат.
Обновление и удаление расширения
Обновляется ReActor через ту же вкладку Extensions → Installed: нажмите Check for updates, затем Apply and restart UI. Если после обновления расширение перестало работать, возможная причина — изменившийся список зависимостей; в этом случае повторно выполните установку пакетов из раздела о ручной установке.
Для полного удаления достаточно убрать галочку с расширения в списке Installed или удалить папку sd-webui-reactor из каталога extensions при выключенном WebUI. Скачанные модели в models/reactor при этом останутся — их можно удалить отдельно вручную.
⚠️ Внимание: технология замены лиц может нарушать права других людей и правила площадок, где публикуются изображения. Используйте ReActor только с фотографиями, на использование которых у вас есть согласие, и не выдавайте обработанные изображения за реальные фотографии.
Часто задаваемые вопросы
Работает ли ReActor в ComfyUI?
В ComfyUI используется отдельная реализация ReActor в виде набора нодов — это другой пакет с собственной процедурой установки через ComfyUI Manager. Инструкция из этой статьи относится только к AUTOMATIC1111 WebUI.
Почему ReActor не появляется после установки?
Чаще всего — ошибка загрузки расширения при старте WebUI. Откройте консоль и найдите строки с упоминанием reactor: там будет указано, какой модуль не удалось импортировать. Обычно помогает установка зависимостей в окружение проекта и полный перезапуск сервера.
Нужна ли мощная видеокарта для ReActor?
Замена лица выполняется отдельными моделями и, как правило, менее требовательна к видеопамяти, чем сама генерация. Если WebUI у вас уже стабильно генерирует изображения, ReActor обычно не добавляет критичной нагрузки.
Куда скачиваются модели ReActor?
При первом использовании веса моделей сохраняются в папку models/reactor внутри каталога WebUI. Если скачивание оборвалось, удалите неполные файлы оттуда и запустите генерацию повторно.
Можно ли менять лицо на уже готовом изображении?
Да. Загрузите готовое изображение во вкладку img2img, включите ReActor с минимальным значением Denoising strength, чтобы картинка почти не перерисовывалась, и активируйте замену лица.