Stable Diffusion WebUI Forge: полное руководство по установке и настройке

Stable Diffusion WebUI Forge — это форк популярного интерфейса AUTOMATIC1111, который заметно снижает потребление видеопамяти и ускоряет генерацию изображений, особенно на видеокартах с объёмом VRAM 6–8 ГБ. Если при запуске webui-user.bat окно консоли закрывается с ошибкой CUDA out of memory или интерфейс зависает на этапе загрузки модели — чаще всего причина в неверных аргументах командной строки или конфликте версий Python-зависимостей.

Ниже разберём установку Forge с нуля, ключевые параметры запуска, типичные ошибки и способы оптимизации под слабые видеокарты. Материал ориентирован на Windows, поскольку именно эта платформа является основной для пользователей Forge.

Чем Forge отличается от оригинального WebUI

Forge построен на той же кодовой базе, что и AUTOMATIC1111 WebUI, поэтому интерфейс и расширения в основном совместимы. Главное отличие — переработанный механизм управления памятью: Forge динамически выгружает неиспользуемые компоненты модели из VRAM, что позволяет работать с SDXL-моделями на картах с 6–8 ГБ видеопамяти без постоянных ошибок.

Дополнительно в Forge встроена поддержка SVD, улучшенная работа с ControlNet и ускоренная загрузка чекпоинтов при переключении между моделями. На практике это означает меньшее время ожидания и более стабильную работу на средних конфигурациях ПК.

  • 🚀 Сниженное потребление VRAM по сравнению с оригинальным WebUI
  • ⚡ Быстрое переключение между чекпоинтами без полной перезагрузки
  • 🧩 Совместимость с большинством расширений AUTOMATIC1111
  • 🎨 Нативная поддержка SDXL и современных форматов моделей

Системные требования и подготовка

Перед установкой убедитесь, что на компьютере установлены Python 3.10.x и Git — именно версия Python 3.10 считается рекомендованной для экосистемы Stable Diffusion. Более новые версии Python могут вызывать конфликты зависимостей при установке пакетов. Проверить версию можно командой python --version в командной строке.

Также потребуется видеокарта NVIDIA с актуальными драйверами. Поддержка AMD в Forge возможна через DirectML или ZLUDA, но такие конфигурации менее стабильны, и их настройку лучше проводить по отдельным инструкциям под конкретную карту.

Пошаговая установка Forge на Windows

Установка выполняется через клонирование репозитория. Откройте командную строку в папке, куда хотите поставить программу, и выполните:

git clone https://github.com/lllyasviel/stable-diffusion-webui-forge.git

После завершения клонирования перейдите в созданную папку и запустите файл webui-user.bat двойным щелчком. При первом запуске установщик автоматически создаст виртуальное окружение и скачает необходимые зависимости — процесс может занять продолжительное время в зависимости от скорости интернета.

Когда в консоли появится строка вида Running on local URL: http://127.0.0.1:7860, откройте этот адрес в браузере. Интерфейс загружен и готов к работе.

☑️ Проверка перед первым запуском Forge

Выполнено: 0 / 5

⚠️ Внимание: не прерывайте первый запуск, пока идёт установка зависимостей. Прерванная установка часто приводит к повреждённому окружению в папке venv — в этом случае проще удалить папку venv и запустить webui-user.bat заново.

Настройка аргументов запуска под вашу видеокарту

Основные параметры запуска задаются в файле webui-user.bat в строке COMMANDLINE_ARGS. Откройте файл в любом текстовом редакторе и добавьте нужные флаги в зависимости от объёма видеопамяти.

  • 🟢 4–6 ГБ VRAM: попробуйте --lowvram — модель будет частично выгружаться в оперативную память
  • 🟡 8 ГБ VRAM: обычно достаточно --medvram либо запуска вообще без флагов, Forge сам подберёт режим
  • 🔵 12+ ГБ VRAM: дополнительные флаги не требуются, можно добавить --xformers для ускорения, если пакет установлен
  • 🌐 Доступ из локальной сети: добавьте --listen и при необходимости --port 7860

Пример строки для карты с 6 ГБ памяти:

set COMMANDLINE_ARGS=--lowvram --xformers

После сохранения файла перезапустите Forge. Если генерация всё равно падает с ошибкой памяти, снизьте разрешение изображения и размер батча в интерфейсе — это самый прямой способ уменьшить нагрузку на VRAM.

📊 Сколько VRAM на вашей видеокарте для работы с Forge?
4–6 ГБ
8 ГБ
12 ГБ
16 ГБ и более

Типичные ошибки и их решение

Большинство проблем при работе с Forge сводится к нескольким повторяющимся сценариям. Ниже — таблица с частыми симптомами и проверяемыми причинами.

СимптомВозможная причинаЧто проверить
CUDA out of memoryНе хватает VRAM под модель и разрешениеФлаги --lowvram, снижение разрешения
Окно консоли сразу закрываетсяPython не найден или неверная версияПроверить python --version, переустановить Python 3.10
Ошибка при установке зависимостейПовреждённое окружение venvУдалить папку venv и запустить заново
Расширение не работаетНесовместимость с версией ForgeПроверить обновления расширения или отключить его
Чёрное изображение на выходеКонфликт VAE или настроек точностиСменить VAE, попробовать флаг --no-half-vae

⚠️ Внимание: перед обновлением Forge через git pull сделайте резервную копию папок models и outputs. Обновления иногда меняют структуру зависимостей, и откат без бэкапа может быть затруднён.

Как полностью сбросить Forge к чистому состоянию

Удалите папки venv и repositories внутри каталога Forge, затем запустите webui-user.bat — установщик пересоздаст окружение с нуля. Модели в папке models при этом не затрагиваются.

Оптимизация скорости генерации

Если Forge работает стабильно, но медленно, начните с простого: убедитесь, что не запущены другие программы, потребляющие видеопамять — браузеры с аппаратным ускорением, игры, видеоредакторы. Даже несколько сотен мегабайт занятой VRAM могут заставить Forge перейти в режим подкачки.

Далее проверьте настройки самого интерфейса. Разрешение изображения влияет на потребление памяти нелинейно: удвоение сторон картинки увеличивает нагрузку примерно вчетверо. Для SDXL-моделей разумный старт — 1024×1024, для моделей SD 1.5 — 512×512 с последующим апскейлом через Hires. fix или Ultimate SD Upscale.

Также обратите внимание на сэмплер: DPM++ 2M Karras и подобные варианты дают хорошее качество при умеренном числе шагов (20–30), тогда как завышение шагов до 50+ редко оправдано и лишь увеличивает время генерации.

Обновление и управление моделями

Обновить Forge можно через командную строку в папке установки:

git pull

После обновления рекомендуется один раз запустить webui-user.bat и дождаться проверки зависимостей — установщик сам подтянет недостающие пакеты. Если после обновления появились ошибки, проверьте расширения: конфликтующее дополнение можно временно отключить на вкладке Extensions.

Модели размещаются в папке models/Stable-diffusion, LoRA — в models/Lora, файлы VAE — в models/VAE. Forge поддерживает те же форматы, что и оригинальный WebUI, поэтому уже скачанные чекпоинты можно просто скопировать из старой установки.

Часто задаваемые вопросы

Можно ли использовать одни и те же модели для Forge и AUTOMATIC1111?

Да, форматы моделей полностью совместимы. Можно даже настроить общую папку моделей для обеих программ через аргумент --ckpt-dir, чтобы не дублировать файлы на диске.

Запустится ли Forge на видеокарте AMD?

Официально Forge ориентирован на NVIDIA. Для AMD существуют обходные пути через DirectML или ZLUDA, но их стабильность зависит от конкретной карты и версии драйверов — сверяйтесь с актуальными инструкциями сообщества под вашу модель.

Почему генерация занимает несколько минут даже на мощной карте?

Проверьте, не активирован ли режим --lowvram без необходимости — он замедляет работу из-за постоянной выгрузки данных. Также убедитесь, что разрешение и число шагов не завышены, а другие программы не занимают VRAM.

Куда Forge сохраняет сгенерированные изображения?

По умолчанию результаты сохраняются в папку outputs внутри каталога установки, с разделением по вкладкам (txt2img, img2img и т.д.). Путь можно изменить в настройках интерфейса.

Нужно ли удалять оригинальный WebUI перед установкой Forge?

Нет, обе программы могут существовать на одном компьютере независимо. Главное — не запускать их одновременно, чтобы избежать конкуренции за видеопамять и порт 7860.