Stable Diffusion WebUI reForge — это форк популярного интерфейса AUTOMATIC1111, созданный для тех, кому нужна оптимизация оригинального Forge без радикальной смены привычного интерфейса. Если при запуске обычного WebUI вы упираетесь в нехватку видеопамяти при генерации в высоком разрешении или замечаете, что Forge несовместим с частью нужных расширений, reForge становится рабочим компромиссом: он берёт ускоренный движок управления памятью из Forge, но сохраняет кодовую базу, близкую к A1111.
В этом материале разберём, чем reForge отличается от других сборок, как его установить на Windows, какие параметры командной строки реально влияют на стабильность и что делать при типичных ошибках запуска. Инструкция ориентирована на пользователей с видеокартами NVIDIA, поскольку именно под CUDA оптимизирована большая часть экосистемы Stable Diffusion.
Что такое reForge и зачем он нужен
reForge — это ответвление (fork) проекта Stable Diffusion WebUI Forge, который, в свою очередь, является переработкой классического AUTOMATIC1111. Идея Forge заключалась в переписывании внутреннего механизма управления ресурсами: модели подгружаются и выгружаются из видеопамяти умнее, что снижает требования к VRAM и ускоряет генерацию на слабых картах.
Однако у оригинального Forge есть известная проблема — из-за глубокой переработки ядра с ним несовместима часть расширений, написанных под A1111. reForge решает её иначе: разработчик перенёс оптимизации памяти на базу, максимально близкую к оригинальному A1111, поэтому совместимость с расширениями заметно выше. По сути, вы получаете скорость Forge и экосистему A1111 в одном флаконе.
- 🚀 Улучшенное управление VRAM — меньше ошибок нехватки памяти при больших разрешениях
- 🧩 Высокая совместимость с расширениями, написанными под AUTOMATIC1111
- ⚡ Ускоренная генерация по сравнению со стоковым A1111 на тех же настройках
- 🔧 Привычный интерфейс — не нужно переучиваться после классического WebUI
Сравнение reForge, Forge и AUTOMATIC1111
Чтобы выбрать подходящую сборку, полезно видеть различия в одном месте. Точные цифры производительности зависят от видеокарты, модели и настроек, поэтому ниже — качественное сравнение, а не выдуманные бенчмарки.
| Критерий | AUTOMATIC1111 | Forge | reForge |
|---|---|---|---|
| Управление VRAM | Базовое | Переработанное | Переработанное |
| Совместимость расширений | Максимальная | Частичная | Высокая |
| Скорость на слабых GPU | Средняя | Высокая | Высокая |
| Поддержка SDXL и новых моделей | Да | Да | Да |
| Активность разработки | Замедлена | Зависит от автора | Зависит от автора |
Когда какую сборку выбрать? Если вы активно используете редкие расширения и не хотите сюрпризов — оставайтесь на A1111 или переходите на reForge. Если важна максимальная скорость на карте с малым объёмом памяти и набор расширений минимален — подойдёт оригинальный Forge. reForge занимает нишу «золотой середины».
Системные требования и подготовка
Перед установкой убедитесь, что система соответствует базовым условиям. Жёстких официальных требований проект не публикует, но на практике для комфортной работы нужны видеокарта NVIDIA с поддержкой CUDA, свежие драйверы и достаточно свободного места на диске — одни только модели в формате checkpoint занимают по несколько гигабайт каждая.
Дополнительно потребуется установленный Python версии 3.10.x — именно эту ветку рекомендует экосистема A1111 и её форков. Другие версии (3.11, 3.12) могут вызывать конфликты зависимостей. Также понадобится Git для клонирования репозитория и последующих обновлений.
⚠️ Внимание: при установке Python обязательно отметьте галочку «Add Python to PATH». Без этого скрипт запуска не найдёт интерпретатор, и вы получите ошибку ещё до начала установки зависимостей.
- 💾 Свободное место на диске — желательно от 20–30 ГБ с запасом под модели
- 🐍 Python 3.10.x с добавлением в PATH
- 🌿 Git для Windows
- 🎮 Актуальный драйвер NVIDIA
Пошаговая установка reForge на Windows
Установка выполняется через командную строку и занимает обычно 10–20 минут в зависимости от скорости интернета — скрипт скачивает PyTorch и прочие зависимости. Порядок действий следующий.
Сначала клонируйте репозиторий в удобную папку. Путь не должен содержать кириллицы и пробелов — это частая причина непонятных сбоев:
git clone https://github.com/Panchovix/stable-diffusion-webui-reForge.gitПосле клонирования перейдите в папку проекта и запустите файл webui-user.bat двойным кликом. При первом запуске скрипт сам создаст виртуальное окружение и установит всё необходимое. Не закрывайте окно консоли, пока процесс не завершится и не появится строка с локальным адресом вида http://127.0.0.1:7860 — именно её нужно открыть в браузере.
☑️ Проверка после установки reForge
Модели (checkpoints) помещайте в папку models/Stable-diffusion внутри каталога reForge. Если у вас уже есть коллекция моделей от другой сборки, не обязательно копировать файлы — можно указать к ним путь через аргументы командной строки, о чём ниже.
Настройка параметров запуска
Основная тонкая настройка reForge выполняется через переменную COMMANDLINE_ARGS в файле webui-user.bat. Откройте его в любом текстовом редакторе и допишите нужные флаги. Вот наиболее востребованные:
set COMMANDLINE_ARGS=--xformers --medvramРазберём, что дают популярные аргументы. Флаг --xformers включает оптимизированную реализацию механизма внимания, что снижает потребление памяти и ускоряет генерацию на поддерживаемых картах. Параметры --medvram и --lowvram предназначены для карт с ограниченной видеопамятью — они дробят вычисления, жертвуя скоростью ради стабильности. Впрочем, благодаря встроенному менеджеру памяти reForge эти флаги требуются реже, чем в чистом A1111.
⚠️ Внимание: не включайте одновременно все «экономящие» флаги «про запас». Избыточная агрессивная оптимизация памяти замедляет генерацию в разы. Добавляйте параметры по одному и проверяйте результат.
Если планируете открывать интерфейс с другого устройства в локальной сети (например, с планшета), добавьте --listen. Для смены порта используется --port с номером. Полный список аргументов доступен в документации репозитория — набор периодически меняется между версиями, поэтому сверяйтесь с актуальным описанием проекта.
Типичные ошибки и их решение
Проблемы при запуске reForge в большинстве случаев сводятся к нескольким повторяющимся сценариям. Начните диагностику с чтения текста ошибки в консоли — последние строки обычно содержат прямое указание на причину.
Частая ситуация — ошибка «CUDA out of memory» при генерации в высоком разрешении. Это значит, что выделенной видеопамяти не хватило для текущего батча. Решения: уменьшите разрешение, включите --medvram, закройте другие программы, потребляющие VRAM (браузер с множеством вкладок, игры), либо используйте Hires. fix вместо прямой генерации большого кадра.
Второй распространённый сценарий — конфликты зависимостей после обновления. Возможная причина: в папке venv остались старые версии библиотек. Проверенный приём — удалить папку venv и запустить webui-user.bat заново, чтобы окружение пересобралось с нуля. Это безопасно: ваши модели и настройки при этом не затрагиваются.
- ❌ Ошибка «Torch is not able to use GPU» — проверьте драйвер NVIDIA и переустановите зависимости через удаление venv
- ❌ Расширение не появляется в интерфейсе — проверьте вкладку с ошибками в консоли, возможно, оно несовместимо с текущей версией
- ❌ Порт 7860 занят — закройте другой запущенный экземпляр WebUI или смените порт через
--port - ❌ Чёрный квадрат вместо изображения — попробуйте отключить VAE-оптимизации или сменить VAE, проблема часто связана с точностью вычислений
Что делать, если reForge вообще не стартует
Откройте командную строку в папке проекта и запустите webui-user.bat вручную через cmd — так окно не закроется при ошибке, и вы увидите полный текст сбоя. Чаще всего причиной оказывается отсутствие Python в PATH, антивирус, заблокировавший скачивание зависимостей, или кириллица в пути к папке.
Обновление и работа с расширениями
Обновляется reForge стандартным для git-проектов способом: откройте командную строку в папке проекта и выполните git pull. Либо используйте встроенный механизм проверки обновлений, если он предусмотрен текущей версией. Перед обновлением имеет смысл сохранить копию файла webui-user.bat с вашими параметрами и список установленных расширений.
Расширения устанавливаются через вкладку Extensions в интерфейсе — из встроенного каталога или по прямой ссылке на git-репозиторий. Хотя совместимость у reForge выше, чем у Forge, гарантии работы каждого конкретного расширения нет: если расширение после установки ломает интерфейс, удалите его папку из каталога extensions и перезапустите WebUI.
⚠️ Внимание: не устанавливайте десятки расширений сразу. Каждое из них увеличивает время запуска и риск конфликтов. Добавляйте по одному, проверяйте работоспособность, и только потом переходите к следующему.
Часто задаваемые вопросы
Чем reForge лучше обычного AUTOMATIC1111?
Главное преимущество — переработанный механизм управления видеопамятью, унаследованный от Forge. На картах с ограниченным объёмом VRAM это даёт меньше ошибок нехватки памяти и более быструю генерацию. Интерфейс и логика работы при этом остаются привычными.
Можно ли использовать одни и те же модели для reForge и A1111?
Да, форматы моделей (checkpoints, LoRA, VAE, embeddings) полностью совместимы. Можно даже указать общую папку через аргумент --ckpt-dir, чтобы не дублировать файлы между установками.
Поддерживает ли reForge видеокарты AMD?
Основная оптимизация экосистемы рассчитана на NVIDIA с CUDA. Запуск на AMD возможен через альтернативные сборки с DirectML или под Linux с ROCm, но это отдельная процедура со своими ограничениями — сверяйтесь с документацией под вашу конфигурацию.
Почему после обновления перестало работать расширение?
Вероятная причина — изменения в коде ядра, с которыми расширение пока несовместимо. Проверьте страницу расширения на наличие обновлений, а если их нет — временно удалите его папку из каталога extensions и дождитесь адаптации автором.
Как полностью удалить reForge?
Достаточно удалить папку проекта — вся установка, включая виртуальное окружение и скачанные зависимости, находится внутри неё и не оставляет следов в системе. Отдельно установленные Python и Git при этом можно оставить для других проектов.