Reforge (Stable Diffusion WebUI reForge) — это форк популярного интерфейса Automatic1111, который пользователи чаще всего ставят, когда оригинальный WebUI начинает тормозить на видеокартах с малым объёмом VRAM или конфликтует с новыми версиями расширений. Форк сохраняет привычный интерфейс A1111, но перерабатывает работу с памятью и ускоряет переключение между моделями, что заметно на картах с 4–8 ГБ видеопамяти.
Ниже разберём, чем reForge отличается от оригинала, как его установить без конфликтов с уже стоящим Automatic1111, какие настройки включить в первую очередь и как решать типичные ошибки запуска.
Что такое reForge и зачем он нужен
Stable Diffusion reForge — это модифицированная версия веб-интерфейса для локальной генерации изображений. Проект берёт за основу кодовую базу Automatic1111, но вносит изменения в механизмы управления памятью, загрузки моделей и работы с расширениями. Для пользователя это выглядит как тот же знакомый интерфейс с вкладками txt2img, img2img, Extras и настройками.
Главная причина перехода на reForge — производительность. Форк оптимизирован под видеокарты с ограниченным объёмом VRAM и сокращает время переключения между чекпоинтами. Если вы генерируете сериями и часто меняете модели или LoRA, разница ощущается сразу.
- 🚀 Более быстрая загрузка и выгрузка моделей из памяти
- 🧠 Улучшенное управление VRAM на слабых видеокартах
- 🔌 Совместимость с большинством расширений для A1111
- 🛠️ Привычный интерфейс без необходимости переучиваться
Отличия reForge от Automatic1111 и Forge
Часто возникает путаница между тремя проектами: оригинальным Automatic1111, форком Forge и reForge. Forge — это отдельная глубокая переработка WebUI с собственным бэкендом, а reForge позиционируется как более лёгкий форк, который ближе к оригиналу по структуре и логике работы.
Точный набор отличий зависит от актуальных версий проектов, которые активно меняются, поэтому перед выбором стоит свериться с описанием репозиториев на GitHub. Общая картина выглядит так:
| Критерий | Automatic1111 | reForge |
|---|---|---|
| Интерфейс | Классический WebUI | Тот же, с небольшими доработками |
| Работа с VRAM | Стандартная | Оптимизирована для слабых карт |
| Скорость смены моделей | Средняя | Выше за счёт кэширования |
| Расширения | Полная поддержка | Совместимость с большинством, но не гарантирована со всеми |
| Активность разработки | Обновляется | Зависит от мейнтейнера форка |
Системные требования и подготовка
Перед установкой убедитесь, что на компьютере уже есть необходимое окружение. Как и оригинальный WebUI, reForge требует Python (обычно версии 3.10.x — точную версию уточняйте в README репозитория, так как несовпадение версии — частая причина ошибок при первом запуске) и Git для клонирования и обновления.
Для комфортной работы желательна видеокарта NVIDIA с поддержкой CUDA. Запуск на CPU или AMD возможен, но требует отдельных параметров и работает заметно медленнее. Место на диске закладывайте с запасом: сами веса программы немного, но чекпоинты моделей занимают по несколько гигабайт каждый.
⚠️ Внимание: не устанавливайте reForge поверх существующей папки Automatic1111. Держите их в отдельных каталогах — смешивание файлов двух веток приводит к конфликтам зависимостей и ошибкам запуска.
Установка reForge по шагам
Процесс установки почти идентичен установке Automatic1111. Сначала клонируется репозиторий, затем запускается скрипт, который сам подтянет зависимости и создаст виртуальное окружение Python.
git clone https://github.com/Panchovix/stable-diffusion-webui-reForge.gitПосле клонирования перейдите в папку проекта и запустите webui-user.bat (Windows) или webui.sh (Linux). Первый запуск может занять продолжительное время — скачиваются библиотеки PyTorch и другие зависимости. Не закрывайте окно консоли, пока не появится строка с локальным адресом вида http://127.0.0.1:7860.
☑️ Проверка после установки reForge
Чтобы не копировать модели заново, можно указать reForge путь к уже существующим папкам A1111 через аргументы командной строки, например --ckpt-dir для чекпоинтов. Это экономит десятки гигабайт на диске.
Настройка и оптимизация под слабую видеокарту
Основная настройка выполняется через аргументы запуска в файле webui-user.bat — строка COMMANDLINE_ARGS. Именно здесь включаются режимы экономии видеопамяти.
- 💾
--medvramили--lowvram— режимы экономии VRAM для карт с малым объёмом памяти (второй агрессивнее и медленнее) - ⚡
--xformers— ускорение вычислений внимания, если библиотека поддерживается вашей конфигурацией - 🔗
--ckpt-dir— общая папка моделей с другой установкой - 🌐
--listen— доступ к интерфейсу из локальной сети (включайте осознанно)
Если генерация всё равно падает с ошибкой нехватки памяти (CUDA out of memory), снизьте разрешение изображения и размер батча, отключите параллельно запущенные тяжёлые приложения — браузер с множеством вкладок тоже занимает VRAM.
Типичные ошибки и их решение
Большинство проблем при запуске reForge связано не с самим форком, а с окружением: версией Python, конфликтами зависимостей или устаревшими расширениями. Разберём частые сценарии.
Ошибка при установке зависимостей. Проверьте версию Python командой python --version. Если установлено несколько версий, убедитесь, что скрипт запускает именно ту, которая указана в требованиях репозитория.
Конфликт расширений. Расширения, написанные под свежие версии A1111, иногда несовместимы с reForge. Диагностика простая: временно переименуйте папку extensions и запустите интерфейс чистым. Если запустился — возвращайте расширения по одному, чтобы найти проблемное.
Чёрный квадрат вместо изображения. Возможная причина — NaN-ошибки при вычислениях в половинной точности. Попробуйте аргументы --no-half и --no-half-vae: генерация станет медленнее и прожорливее по памяти, но проблема обычно уходит.
⚠️ Внимание: не обновляйте расширения и сам форк одновременно «вслепую». Обновляйте по очереди и проверяйте запуск после каждого шага — иначе при ошибке будет непонятно, что именно сломало систему.
Как полностью сбросить установку
Удалите папки venv и repositories внутри каталога reForge, затем запустите webui-user.bat заново — зависимости скачаются и установятся с нуля. Сами модели и сгенерированные изображения при этом не пострадают.
Перенос моделей и результатов из A1111
Модели, LoRA, VAE и эмбеддинги у reForge и Automatic1111 полностью совместимы — это одни и те же файлы форматов .safetensors и .ckpt. Достаточно указать форку пути к существующим папкам или вручную скопировать файлы в соответствующие каталоги: models/Stable-diffusion, models/Lora, models/VAE.
Промпты из старых генераций тоже не теряются: метаданные хранятся внутри PNG-файлов, и вкладка PNG Info в reForge читает их так же, как в оригинале. Можно перетащить старую картинку на эту вкладку и отправить параметры в txt2img одной кнопкой.
⚠️ Внимание: перед любыми экспериментами с обновлениями и переносом сделайте резервную копию папки outputs и файла с настройками — восстановление занимает минуты, а переустановка с нуля — часы.
Часто задаваемые вопросы
Чем reForge отличается от Forge?
Forge — глубокая переработка WebUI с изменённым бэкендом, а reForge ближе к оригинальному Automatic1111 по структуре. Оба нацелены на оптимизацию памяти и скорости, но имеют разные кодовые базы и разную совместимость с расширениями. Практический совет — попробовать оба на своей конфигурации и оставить тот, что стабильнее.
Подойдут ли модели и LoRA от Automatic1111?
Да, форматы файлов идентичны: чекпоинты .safetensors, LoRA, VAE и эмбеддинги работают без конвертации. Можно указать общую папку через аргумент --ckpt-dir, чтобы не дублировать файлы.
Почему reForge не запускается после обновления?
Частые причины — конфликт зависимостей или несовместимое расширение. Попробуйте запуск с отключёнными расширениями, а если не поможет — удалите папку venv и дайте скрипту переустановить зависимости с нуля.
Можно ли запускать reForge на видеокарте AMD?
Возможность зависит от версии проекта и используемого бэкенда PyTorch (DirectML, ROCm или ZLUDA). Такие конфигурации менее предсказуемы, чем NVIDIA с CUDA, поэтому сверяйтесь с актуальной документацией репозитория по вашей карте и операционной системе.
Нужно ли удалять Automatic1111 перед установкой reForge?
Нет. Устанавливайте reForge в отдельную папку — обе программы могут работать на одном компьютере независимо и даже использовать общие каталоги моделей.