Установка Stable Diffusion ReForge чаще всего останавливается на этапе первого запуска webui-user.bat: консоль зависает на клонировании репозиториев или выдаёт ошибку Torch, если версия Python не подходит под требования проекта. ReForge — это форк популярного интерфейса AUTOMATIC1111, оптимизированный под слабые видеокарты и ускоренную генерацию, поэтому корректная подготовка окружения здесь критична.
В этом руководстве разберём полный цикл: проверку железа, установку зависимостей, загрузку самого ReForge, добавление моделей и решение типовых ошибок. Инструкция ориентирована на Windows 10/11 — именно там у пользователей возникает больше всего вопросов.
Системные требования и подготовка ПК
Перед загрузкой файлов убедитесь, что компьютер соответствует минимальным требованиям. ReForge ценится за работу на картах с малым объёмом видеопамяти, но совсем слабое железо всё равно станет узким местом.
- 🎮 Видеокарта NVIDIA с поддержкой CUDA — желательно от 4 ГБ видеопамяти; на картах AMD и встроенной графике установка возможна, но требует отдельных параметров запуска.
- 💾 Свободное место на диске — минимум 20–30 ГБ: сам интерфейс, зависимости Python и хотя бы одна модель в формате .safetensors занимают заметный объём.
- 🧠 Оперативная память — от 8 ГБ, комфортно от 16 ГБ, особенно если планируется работа с расширениями.
- 🌐 Стабильный интернет — при первом запуске скачиваются гигабайты зависимостей.
Отдельно проверьте, что драйверы NVIDIA обновлены до актуальной версии. Устаревший драйвер — частая причина ошибок CUDA out of memory и падений при инициализации Torch даже на мощной карте.
Установка Python и Git
ReForge работает на Python 3.10.x — это принципиальный момент. Версии 3.11 и новее на момент написания могут вызывать несовместимость с зависимостями, а 3.9 и старше не поддерживаются частью библиотек. Скачайте установщик Python 3.10 с официального сайта python.org.
При установке обязательно отметьте галочку Add Python to PATH на первом экране установщика — без этого консоль не найдёт интерпретатор, и скрипт запуска завершится с ошибкой. Проверить результат можно командой:
python --versionВторой обязательный компонент — Git. Он нужен не только для клонирования репозитория ReForge, но и для автоматической загрузки встроенных репозиториев при первом старте. Скачайте установщик с git-scm.com и установите с параметрами по умолчанию. Проверка: git --version в командной строке.
⚠️ Внимание: если Python уже установлен, но другой версии, не удаляйте его вслепую — сначала проверьте, не используется ли он другими программами. Несколько версий Python могут сосуществовать, но переменная PATH должна указывать на 3.10.
Загрузка и установка ReForge
Выберите папку для установки. Путь к ней не должен содержать кириллицу, пробелы и спецсимволы — иначе скрипты запуска и часть расширений будут падать с труднодиагностируемыми ошибками. Хороший вариант: C:\ReForge или D:\AI\reforge.
Откройте командную строку в выбранной папке (введите cmd в адресной строке Проводника) и выполните клонирование официального репозитория:
git clone https://github.com/Panchovix/stable-diffusion-webui-reForge.gitДождитесь завершения загрузки, затем перейдите в созданную папку и запустите файл webui-user.bat двойным кликом. Первый запуск займёт заметное время: скрипт создаст виртуальное окружение venv, скачает PyTorch и клонирует вспомогательные репозитории. Не закрывайте окно консоли, даже если кажется, что процесс завис.
☑️ Проверка перед первым запуском
Первый запуск и параметры командной строки
Когда установка завершится, в консоли появится строка вида Running on local URL: http://127.0.0.1:7860. Откройте этот адрес в браузере — перед вами интерфейс ReForge. Если браузер не открылся автоматически, скопируйте адрес вручную.
Для слабых видеокарт полезно отредактировать webui-user.bat, добавив аргументы в строку COMMANDLINE_ARGS. Откройте файл в блокноте и измените строку, например:
set COMMANDLINE_ARGS=--medvram --xformers- ⚡
--medvramили--lowvram— снижают потребление видеопамяти ценой скорости. - 🚀
--xformers— ускоряет генерацию на поддерживаемых картах NVIDIA. - 🎯
--autolaunch— автоматически открывает интерфейс в браузере после старта.
Какие именно флаги поддерживает ваша сборка, можно посмотреть в документации репозитория — набор аргументов периодически меняется между версиями.
Добавление моделей
Без файла модели ReForge запустится, но генерировать изображения не сможет. Модели в формате .safetensors или .ckpt скачиваются с площадок вроде Civitai или Hugging Face и помещаются в папку:
stable-diffusion-webui-reForge\models\Stable-diffusionПосле копирования файла нажмите кнопку обновления рядом с выпадающим списком моделей в левом верхнем углу интерфейса — новая модель появится в списке. Первая загрузка модели в память занимает время, особенно на системах с HDD.
Дополнительные компоненты раскладываются по своим каталогам: LoRA — в models\Lora, VAE — в models\VAE, эмбеддинги — в папку embeddings в корне установки. Неправильное размещение файлов — частая причина того, что компонент «не виден» в интерфейсе.
Чем checkpoint отличается от LoRA
Checkpoint (чекпоинт) — полная модель весом в несколько гигабайт, определяющая стиль и качество генерации. LoRA — небольшой дополнительный файл, который работает только поверх выбранного чекпоинта и подмешивает конкретный стиль, персонажа или объект.
Типичные ошибки и их решение
Большинство проблем при установке сводится к нескольким повторяющимся сценариям. Ниже — таблица симптомов и действий.
| Ошибка | Вероятная причина | Что сделать |
|---|---|---|
| Python не найден | Не отмечен Add to PATH | Переустановить Python 3.10 с галочкой PATH |
| Ошибка клонирования репозиториев | Git не установлен или блокировка сети | Проверить git --version и соединение |
| CUDA out of memory | Нехватка VRAM | Добавить --medvram или --lowvram |
| Зависание на Installing torch | Медленная загрузка пакетов | Дождаться завершения, не закрывая консоль |
| Модель не видна в списке | Файл не в той папке | Проверить models\Stable-diffusion |
⚠️ Внимание: не прерывайте первый запуск кнопкой закрытия окна на этапе установки зависимостей — повреждённое окружение venv придётся удалять и создавать заново. Если процесс явно завис надолго, закройте консоль через диспетчер задач и запустите webui-user.bat повторно: установка продолжится с места обрыва.
Если после всех проверок ReForge не стартует, удалите папку venv внутри каталога установки и запустите bat-файл снова — это заставит скрипт пересоздать окружение с нуля. Также имеет смысл свериться с разделом Issues в репозитории проекта: нестандартные ошибки часто уже описаны другими пользователями.
Обновление ReForge
Проект активно развивается, поэтому периодически обновляйте локальную копию. Откройте командную строку в папке установки и выполните:
git pullПосле обновления расширения могут потребовать совместимых версий — проверьте вкладку Extensions в интерфейсе. Если после апдейта что-то сломалось, откат на предыдущий коммит выполняется средствами Git, но делать это стоит только при понимании последствий.
Часто задаваемые вопросы
Можно ли установить ReForge без видеокарты NVIDIA?
Технически возможна работа на CPU или картах AMD, но это требует отдельных параметров запуска и даёт очень низкую скорость генерации. Для комфортной работы нужна карта NVIDIA с поддержкой CUDA.
Чем ReForge отличается от обычного AUTOMATIC1111?
ReForge — форк оригинального WebUI с оптимизациями скорости и сниженным потреблением видеопамяти. Интерфейс и логика работы во многом совпадают, поэтому инструкции и расширения для A1111 в основном применимы и к ReForge.
Сколько места занимает установка вместе с моделями?
Сам интерфейс с зависимостями занимает порядка 10 ГБ и более за счёт PyTorch. Каждая модель добавляет обычно от 2 до 7 ГБ, поэтому запас в 20–30 ГБ на диске — разумный минимум.
Почему консоль зависла при первом запуске?
Чаще всего это не зависание, а длительная загрузка PyTorch и клонирование репозиториев — процесс может идти десятки минут без видимого прогресса. Дождитесь появления строки с локальным адресом.
Куда копировать скачанные модели?
Основные модели — в models\Stable-diffusion, LoRA — в models\Lora, VAE — в models\VAE. После копирования нажмите кнопку обновления списка в интерфейсе.