Установка Stable Diffusion WebUI Forge чаще всего зависает на одном и том же месте: после запуска webui-user.bat консоль выдаёт ошибку про отсутствующий Git или несовместимую версию Python, и веб-интерфейс так и не открывается. Причина почти всегда в том, что система подготовлена не полностью — Forge, в отличие от обычных программ, не имеет классического установщика и собирает рабочее окружение прямо на вашем компьютере при первом запуске.
Эта инструкция описывает установку Forge на Windows с нуля: от проверки требований до первого сгенерированного изображения. Отдельно разберём типичные ошибки первого запуска и способы их устранения без переустановки всего пакета.
Что такое Forge и чем он отличается от обычного WebUI
Stable Diffusion WebUI Forge — это форк популярного интерфейса AUTOMATIC1111, переработанный с упором на скорость работы и снижение потребления видеопамяти. Разработчик переписал внутреннюю систему управления ресурсами, поэтому на слабых видеокартах генерация идёт заметно стабильнее, а переключение между моделями занимает меньше времени.
Интерфейс при этом остался привычным: те же вкладки txt2img, img2img, поддержка расширений и стандартных чекпоинтов в формате .safetensors. Если вы раньше работали с классическим WebUI, переучиваться не придётся.
Системные требования и подготовка
Перед загрузкой Forge проверьте три вещи: видеокарту, свободное место на диске и наличие необходимых системных компонентов. Пропуск этого этапа — самая частая причина неудачной установки.
- 🎮 Видеокарта NVIDIA с поддержкой CUDA — желательно от 4–6 ГБ видеопамяти, на меньшем объёме потребуются специальные флаги запуска
- 💾 Свободное место на диске — сам Forge занимает немного, но каждая модель весит от 2 до 7 ГБ, поэтому закладывайте минимум 20–30 ГБ
- 🐍 Python версии 3.10.x — Forge ориентирован именно на эту ветку, другие версии могут вызвать конфликты зависимостей
- 🔧 Git для Windows — без него скрипт не сможет клонировать репозиторий и обновлять компоненты
Обновите также драйвер видеокарты до актуальной версии с официального сайта NVIDIA. Устаревший драйвер — возможная причина ошибок CUDA при первом запуске, и проще исключить её заранее.
⚠️ Внимание: устанавливайте Forge в папку, путь к которой не содержит кириллицы и пробелов. Путь видаC:\Нейросети\Мой Forge\способен сломать установку зависимостей — используйте что-то вродеD:\forge\.
Установка Git и Python
Начните с Git. Скачайте установщик с официального сайта git-scm.com и установите с параметрами по умолчанию — этого достаточно. Проверить успешность можно командой в терминале:
git --versionЕсли команда возвращает номер версии — всё в порядке. Если система пишет, что команда не найдена, перезагрузите компьютер, чтобы обновились переменные окружения.
С Python ситуация тоньше. Вам нужна версия 3.10 (например, 3.10.11), которую можно взять с официального сайта python.org в разделе архивных релизов. При установке обязательно отметьте галочку Add Python to PATH — без неё скрипт Forge не найдёт интерпретатор, и установка прервётся с ошибкой.
Загрузка и установка Forge
Когда окружение готово, переходите к самому Forge. Есть два способа получить файлы: клонировать репозиторий через Git или скачать архив с GitHub. Первый вариант предпочтительнее — он упрощает будущие обновления.
Откройте терминал в папке, куда хотите установить программу, и выполните:
git clone https://github.com/lllyasviel/stable-diffusion-webui-forge.gitДальше действуйте по чек-листу:
☑️ Первый запуск Forge
Запустите файл webui-user.bat двойным кликом. Первый запуск долгий — скрипт скачивает PyTorch и десятки зависимостей, на это может уйти от десяти минут до получаса в зависимости от скорости интернета. Не закрывайте окно консоли, даже если кажется, что процесс завис.
Когда в консоли появится строка вида Running on local URL: http://127.0.0.1:7860, откройте этот адрес в браузере. Перед вами — рабочий интерфейс Forge.
Добавление моделей
Свежий Forge поставляется без моделей, поэтому генерация сразу не заработает — список чекпоинтов в левом верхнем углу будет пустым. Модели нужно скачать отдельно, например с площадки Civitai или Hugging Face, и положить в папку:
stable-diffusion-webui-forge\models\Stable-diffusion\Поддерживаются файлы форматов .safetensors и .ckpt, при этом первый предпочтительнее с точки зрения безопасности. После добавления файла нажмите кнопку обновления рядом со списком моделей в интерфейсе — перезапускать программу не нужно.
- 📦 Чекпоинты SD 1.5 — лёгкие, подходят для слабых видеокарт
- 🚀 Модели SDXL — выше качество детализации, но требуют больше VRAM
- 🎨 LoRA и эмбеддинги — раскладываются по одноимённым подпапкам в
models\
⚠️ Внимание: скачивайте модели только с известных площадок и предпочитайте формат.safetensors— файлы.ckptтехнически могут содержать исполняемый код, и это реальный вектор заражения, а не теоретический риск.
Настройка для слабых видеокарт
Если у вашей карты мало видеопамяти, Forge можно запустить с особыми аргументами. Откройте файл webui-user.bat в текстовом редакторе и найдите строку set COMMANDLINE_ARGS=. Допишите в неё нужные флаги, например:
set COMMANDLINE_ARGS=--lowvram --xformersФлаг --lowvram снижает потребление VRAM ценой скорости, а --xformers ускоряет генерацию на поддерживаемых картах. Впрочем, одна из сильных сторон Forge в том, что он часто сам подбирает оптимальный режим — сначала попробуйте запуск вообще без аргументов и добавляйте их только при ошибках нехватки памяти.
Типичные ошибки при установке
Разберём проблемы, с которыми пользователи сталкиваются чаще всего. Таблица поможет быстро сориентироваться:
| Ошибка | Вероятная причина | Решение |
|---|---|---|
| git не является командой | Git не установлен или не в PATH | Переустановить Git, перезагрузить ПК |
| Python not found | Не отмечен Add to PATH | Переустановить Python 3.10 с галочкой PATH |
| CUDA out of memory | Нехватка видеопамяти | Флаги --lowvram или --medvram |
| Зависание при скачивании torch | Медленная сеть или блокировка | Подождать, проверить соединение |
| Пустой список моделей | Модели не добавлены в папку | Положить .safetensors в models\Stable-diffusion |
⚠️ Внимание: если установка зависимостей прервалась на середине, не запускайте скрипт повторно «поверх» — удалите папкуvenvвнутри каталога Forge и запуститеwebui-user.batзаново. Так виртуальное окружение соберётся чисто.
Как обновить Forge до свежей версии
Откройте терминал в папке Forge и выполните команду git pull. Если вы скачивали программу архивом, обновление через Git работать не будет — придётся скачать свежий архив и перенести папку models в новую установку.
Если ни один из вариантов не помог, изучите полный текст ошибки в консоли — последние строки обычно содержат конкретную причину. По этому тексту имеет смысл искать решение в разделе Issues репозитория Forge на GitHub: большинство проблем там уже описаны.
Часто задаваемые вопросы
Можно ли установить Forge на видеокарту AMD?
Официально Forge ориентирован на карты NVIDIA с CUDA. Запуск на AMD возможен через альтернативные сборки с поддержкой DirectML или ROCm, но это отдельная процедура с собственными ограничениями — сверяйтесь с актуальной документацией проекта.
Сколько места нужно для полноценной работы?
Сама программа с зависимостями занимает порядка 10 ГБ после установки всех компонентов. Каждая модель добавляет от 2 до 7 ГБ, поэтому комфортный запас — 30 ГБ и больше.
Нужен ли интернет после установки?
Нет. После того как все зависимости скачаны и модели лежат локально, Forge работает полностью офлайн. Интернет понадобится только для обновлений и загрузки новых моделей.
Можно ли использовать модели от обычного AUTOMATIC1111?
Да, форматы полностью совместимы. Достаточно скопировать файлы из папки models старой установки в соответствующие подпапки Forge либо указать общий путь через аргументы командной строки.
Что делать, если интерфейс открывается, но генерация не запускается?
Проверьте, выбрана ли модель в выпадающем списке сверху, и посмотрите консоль на предмет ошибок нехватки памяти. Часто помогает снижение разрешения изображения или добавление флага --lowvram.