Запуск webui-user.bat из ветки master репозитория AUTOMATIC1111/stable-diffusion-webui нередко завершается ошибкой ещё на этапе клонирования зависимостей — и причина почти всегда в отсутствующем Git, неподходящей версии Python или конфликте виртуального окружения. Ветка master — это основная стабильная линия разработки WebUI, именно её получает большинство пользователей при стандартном клонировании репозитория.
В этом руководстве разберём, что представляет собой ветка master, как корректно установить Stable Diffusion WebUI на Windows, какие параметры запуска задать под вашу видеокарту и как диагностировать типичные сбои. Материал ориентирован на локальный запуск на ПК с GPU NVIDIA, но часть советов применима и к другим конфигурациям.
Что такое ветка master в Stable Diffusion WebUI
Репозиторий AUTOMATIC1111/stable-diffusion-webui на GitHub содержит несколько веток. master — основная ветка, в которую попадают проверенные изменения. Рядом существует ветка dev, куда новые функции попадают раньше, но с большим риском нестабильной работы. Для повседневной генерации изображений рекомендуется именно master.
Проверить, на какой ветке вы находитесь, можно командой в терминале из папки установки:
git branchСтрока со звёздочкой покажет активную ветку. Если по какой-то причине вы оказались на dev или отдельном коммите, вернуться на master можно командой git checkout master. Перед переключением убедитесь, что локальные изменения не будут потеряны.
Системные требования и подготовка
Перед установкой проверьте окружение. WebUI чувствителен к версиям Python: проект historically рассчитан на Python 3.10.x — более новые ветки (3.11, 3.12) могут вызывать конфликты зависимостей, поэтому безопаснее использовать 3.10. Также потребуется установленный Git и видеокарта с достаточным объёмом видеопамяти.
- 🐍 Python 3.10.x — при установке отметьте галочку добавления в PATH.
- 🌿 Git для Windows — без него клонирование репозитория невозможно.
- 🎮 GPU NVIDIA с поддержкой CUDA — для комфортной генерации желательно от 6–8 ГБ VRAM, хотя есть режимы для слабых карт.
- 💾 Свободное место на диске — сам интерфейс, зависимости и модели занимают десятки гигабайт.
⚠️ Внимание: не устанавливайте WebUI в папки с кириллицей или пробелами в пути (например, C:\Пользователи\Имя\...). Ряд скриптов и расширений некорректно обрабатывает такие пути, что приводит к труднодиагностируемым ошибкам.
Установка WebUI из ветки master
Установка сводится к клонированию репозитория и первому запуску скрипта, который сам подтянет зависимости. Откройте терминал в нужной папке и выполните:
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.gitЗатем перейдите в созданную папку и запустите webui-user.bat двойным кликом. При первом старте скрипт создаст виртуальное окружение venv, скачает PyTorch и остальные пакеты — это может занять продолжительное время в зависимости от скорости сети. Не закрывайте окно консоли, пока процесс не завершится.
☑️ Проверка после первого запуска
Если в консоли появилась строка Running on local URL: http://127.0.0.1:7860, значит сервер запущен. Откройте этот адрес в браузере — вы увидите интерфейс WebUI с вкладками txt2img, img2img и другими.
Настройка параметров запуска под вашу видеокарту
Флаги запуска задаются в файле webui-user.bat в строке COMMANDLINE_ARGS. Откройте файл в текстовом редакторе и допишите нужные аргументы. Правильный набор флагов зависит от объёма VRAM вашей карты.
| Флаг | Назначение | Кому нужен |
|---|---|---|
--xformers | Оптимизация внимания, экономия VRAM и ускорение | Владельцам NVIDIA с поддержкой xFormers |
--medvram | Снижение потребления видеопамяти ценой скорости | Карты с малым объёмом VRAM |
--lowvram | Агрессивная экономия VRAM | Очень слабые GPU |
--autolaunch | Автоматическое открытие браузера при старте | Для удобства |
--api | Включение REST API | Для интеграций и внешних инструментов |
Пример строки для карты со средним объёмом памяти:
set COMMANDLINE_ARGS=--xformers --autolaunch⚠️ Внимание: флаги--medvramи--lowvramне стоит включать «на всякий случай» — они замедляют генерацию. Добавляйте их только если сталкиваетесь с ошибками нехватки памяти CUDA out of memory.
Подключение моделей и обновление WebUI
Без файла модели генерация невозможна — интерфейс запустится, но выдаст ошибку при попытке создать изображение. Модели в форматах .safetensors или .ckpt помещаются в папку models/Stable-diffusion. После добавления файла нажмите кнопку обновления рядом с выпадающим списком моделей в интерфейсе или перезапустите WebUI.
Отдавайте предпочтение формату .safetensors: в отличие от .ckpt, он не допускает исполнения произвольного кода при загрузке, что снижает риск при скачивании моделей из сторонних источников. Файлы .ckpt из непроверенных источников могут содержать вредоносный код — это одна из реальных угроз экосистемы Stable Diffusion.
Обновление WebUI до актуального состояния ветки master выполняется стандартной командой Git в папке установки:
git pull- 🔄 Обновляйтесь при закрытом WebUI, чтобы избежать конфликтов файлов.
- 🧩 После крупных обновлений часть расширений может временно перестать работать — проверяйте их совместимость.
- 📁 Ваши модели и настройки в папках
modelsиoutputsприgit pullне затрагиваются.
Что делать, если git pull сообщает о конфликтах локальных изменений
Выполните git stash, чтобы временно убрать локальные правки, затем git pull, затем git stash pop для возврата изменений. Если правки не нужны — git checkout . отменит их полностью.
Типичные ошибки и их диагностика
Большинство проблем при работе с веткой master относятся к нескольким устойчивым категориям. Ниже — порядок безопасной диагностики без переустановки всего окружения.
- 🐍 Ошибки Python при старте — проверьте версию командой
python --version; если она отличается от 3.10.x, удалите папкуvenvи перезапуститеwebui-user.batпосле установки подходящей версии. - 🧠 CUDA out of memory — снизьте разрешение генерации, уменьшите batch size, добавьте
--medvram. - 📦 Ошибки установки зависимостей — удалите папку
venvи запустите скрипт заново, чтобы окружение пересоздалось с нуля. - 🔌 Порт 7860 занят — завершите предыдущий процесс WebUI или задайте другой порт флагом
--port.
Если ошибка появилась сразу после обновления, возможная причина — несовместимость установленных расширений с новой версией. Проверьте это, временно переименовав папку extensions: если WebUI запустился, проблема в одном из дополнений, и его можно найти методом поочередного возврата папок.
FAQ: частые вопросы о Stable Diffusion WebUI master
Чем ветка master отличается от dev?
Master — стабильная ветка, куда попадают проверенные изменения. Dev получает новые функции раньше, но может содержать ошибки. Для обычной генерации рекомендуется master.
Можно ли запускать WebUI без видеокарты NVIDIA?
Да, существуют режимы для CPU и решения для AMD, но генерация на процессоре идёт значительно медленнее. Для AMD-конфигураций порядок установки отличается — сверяйтесь с официальной документацией репозитория под вашу платформу.
Удалятся ли мои модели при обновлении через git pull?
Нет. Папки models, outputs и пользовательские настройки не входят в отслеживаемые Git файлы и при обновлении не затрагиваются.
Почему после обновления перестали работать расширения?
Расширения разрабатываются независимо и могут отставать от изменений в master. Обновите расширения через вкладку Extensions или временно отключите проблемное, переименовав его папку.
Как полностью переустановить WebUI, не потеряв модели?
Сохраните папки models и outputs, удалите остальное, склонируйте репозиторий заново и верните сохранённые папки на место до первого запуска.