Репозиторий github.com/AUTOMATIC1111/stable-diffusion-webui — это самый популярный интерфейс для локальной генерации изображений нейросетью Stable Diffusion, и ошибка вида Torch is not able to use GPU при первом запуске webui-user.bat встречается чаще всего из-за несоответствия версии PyTorch и драйвера видеокарты. Проект распространяется бесплатно под лицензией AGPL-3.0, написан на Python и работает на Windows, Linux и частично на macOS.
Ниже разберём, что находится в репозитории, как правильно клонировать и установить WebUI, какие системные требования нужны для комфортной работы и как решать типичные ошибки запуска. Материал ориентирован на пользователей Windows, но основные принципы применимы и к Linux.
Что представляет собой репозиторий AUTOMATIC1111 на GitHub
Репозиторий stable-diffusion-webui — это веб-интерфейс на базе Gradio, который оборачивает модели Stable Diffusion в удобную панель управления, доступную через браузер. После запуска интерфейс открывается по локальному адресу http://127.0.0.1:7860, и вся генерация происходит на вашем компьютере без отправки данных в облако.
Внутри проекта реализованы основные режимы работы: txt2img (генерация по текстовому описанию), img2img (преобразование исходного изображения), inpainting, outpainting, апскейл и обучение текстовых инверсий. Код открыт, и сообщество поддерживает сотни расширений, подключаемых прямо из интерфейса.
- 🎨 txt2img и img2img — базовые режимы генерации изображений по промпту
- 🧩 Система расширений — установка дополнений одной кнопкой из вкладки Extensions
- 📦 Поддержка моделей — чекпоинты формата .ckpt и .safetensors, LoRA, VAE, ControlNet через расширение
- ⚙️ Гибкие параметры запуска — флаги командной строки для слабых видеокарт и нестандартных конфигураций
Системные требования и подготовка
Минимальное условие для работы WebUI — видеокарта NVIDIA с поддержкой CUDA и достаточным объёмом видеопамяти. Комфортная генерация в разрешении 512×512 обычно требует порядка 4 ГБ VRAM, а для больших разрешений и SDXL-моделей желательно 8 ГБ и больше. Работа на AMD возможна под Linux с ROCm, а на Windows — через экспериментальные сборки или DirectML-форк, но стабильность таких конфигураций ниже.
Также потребуется установленный Python 3.10.x (именно этой ветки — более новые версии могут быть несовместимы с зависимостями проекта) и Git для клонирования репозитория. При установке Python обязательно отметьте галочку Add Python to PATH, иначе скрипт запуска не найдёт интерпретатор.
⚠️ Внимание: не устанавливайте WebUI в папки с кириллицей или пробелами в пути (например, C:\Пользователи\Имя\...). Ряд скриптов и расширений некорректно обрабатывает такие пути, что приводит к ошибкам загрузки моделей и зависимостей.
| Компонент | Минимально | Рекомендуется |
|---|---|---|
| Видеокарта | NVIDIA с 4 ГБ VRAM | NVIDIA с 8+ ГБ VRAM |
| Оперативная память | 8 ГБ | 16 ГБ и более |
| Python | 3.10.x | 3.10.x (64-bit) |
| Свободное место на диске | ~10 ГБ | 30+ ГБ (SSD) под модели |
| ОС | Windows 10 / Linux | Windows 10/11, Ubuntu-подобные дистрибутивы |
Установка WebUI на Windows: пошаговая инструкция
Установка сводится к клонированию репозитория и запуску готового bat-файла — скрипт сам создаст виртуальное окружение и скачает зависимости. Процедура выглядит так:
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git
cd stable-diffusion-webui
webui-user.bat
При первом запуске скрипт загрузит PyTorch и остальные пакеты — это может занять заметное время в зависимости от скорости соединения. Прерывать процесс не стоит: при обрыве часть пакетов окажется недокачанной, и следующий запуск может завершиться ошибкой импорта. После успешной установки в консоли появится строка Running on local URL: http://127.0.0.1:7860 — откройте этот адрес в браузере.
☑️ Проверка перед первым запуском WebUI
Модель придётся скачать отдельно: сам репозиторий не содержит весов нейросети. Файл чекпоинта в формате .safetensors помещается в папку models/Stable-diffusion, после чего появляется в выпадающем списке в левом верхнем углу интерфейса.
Запуск на Linux и macOS
На Linux установка выполняется аналогично, но запускается скрипт webui.sh. Предварительно через пакетный менеджер ставятся Python 3.10, Git и, при необходимости, библиотека libgl1, без которой OpenCV может не запуститься. Для видеокарт AMD под Linux WebUI способен работать через ROCm — флаг --precision full --no-half иногда требуется для стабильности, но конкретный набор параметров зависит от карты и версии драйвера.
На macOS с чипами Apple Silicon WebUI запускается через фреймворк Metal Performance Shaders, однако скорость генерации и совместимость расширений заметно уступают варианту с NVIDIA. Часть функций (например, отдельные сэмплеры или xformers) на macOS может быть недоступна — это ограничение экосистемы, а не ошибка установки.
Типичные ошибки запуска и их решения
Большинство проблем при старте WebUI связано с окружением Python, видеодрайвером или нехваткой видеопамяти. Разберём самые частые сценарии.
Ошибка Torch is not able to use GPU. Возможная причина — установилась CPU-версия PyTorch или драйвер NVIDIA устарел. Проверьте актуальность драйвера через официальную утилиту NVIDIA, затем удалите папку venv внутри WebUI и запустите webui-user.bat заново — зависимости переустановятся с нуля.
Ошибка out of memory (CUDA out of memory). Видеопамяти не хватает для выбранного разрешения и размера батча. Откройте файл webui-user.bat и добавьте в строку COMMANDLINE_ARGS флаг --medvram, а при совсем малом объёме VRAM — --lowvram. Это замедлит генерацию, но позволит работать на слабых картах.
Конфликты версий Python. Если в системе несколько интерпретаторов, скрипт может подхватить не тот. Укажите путь к Python 3.10 явно, добавив в webui-user.bat строку set PYTHON=путь\к\python.exe.
⚠️ Внимание: флаг--lowvramсущественно замедляет генерацию, потому что модель постоянно выгружается из видеопамяти. Сначала попробуйте--medvram— это более мягкий режим оптимизации, и переходите к--lowvramтолько если ошибка нехватки памяти сохраняется.
Что делать, если ошибка не исчезает
Удалите папки venv и repositories внутри каталога WebUI, затем перезапустите webui-user.bat — это принудительно пересоздаст окружение. Также проверьте лог в консоли: первая строка с traceback обычно указывает на конкретный пакет или файл, вызвавший сбой. Если проблема появилась после обновления, откатитесь на предыдущий коммит командой git checkout с хешем нужной версии.
Расширения и обновление WebUI
Экосистема расширений — одна из главных причин популярности именно этого интерфейса. Установка выполняется через вкладку Extensions → Install from URL: достаточно вставить ссылку на GitHub-репозиторий дополнения и нажать Install. Среди популярных — ControlNet для управления композицией по референсу, расширения для апскейла и работы с анимацией.
Обновление самого WebUI выполняется командой git pull в папке проекта либо автоматически при запуске, если не отключена соответствующая опция. Учтите: после крупных обновлений WebUI часть расширений может временно перестать работать, пока их авторы не выпустят совместимые версии. Если стабильность важнее новых функций, имеет смысл не обновляться сразу, а дождаться отзывов сообщества.
Безопасность при работе с моделями и расширениями
Поскольку модели и расширения скачиваются со сторонних ресурсов, стоит соблюдать базовые меры предосторожности. Файлы формата .ckpt технически могут содержать исполняемый код — WebUI при загрузке таких файлов выводит предупреждение. Предпочтительный формат — .safetensors, лишённый этого недостатка.
Расширения выполняются с правами самого WebUI, то есть фактически получают доступ к вашей системе. Устанавливайте дополнения только из известных репозиториев с историей коммитов и звёздами на GitHub, а перед обновлением расширений просматривайте список изменений. Не запускайте WebUI с флагом --listen (открывает интерфейс в локальную сеть) без понимания рисков, и тем более не пробрасывайте порт 7860 в интернет без авторизации — параметр --gradio-auth позволяет задать логин и пароль.
⚠️ Внимание: никогда не запускайте WebUI с флагом--shareили--listenна машине, где хранятся чувствительные данные, без настроенной аутентификации. Открытый интерфейс позволяет любому, кто знает адрес, выполнять код через расширения и получать доступ к файлам генерации.
FAQ: частые вопросы о Stable Diffusion WebUI
Чем AUTOMATIC1111 WebUI отличается от ComfyUI?
WebUI от AUTOMATIC1111 использует классический интерфейс с вкладками и формами — он проще для новичков. ComfyUI построен на нодовой (узловой) системе, даёт более гибкий контроль над конвейером генерации, но требует больше времени на освоение. Оба проекта бесплатны и работают локально.
Можно ли запустить WebUI без видеокарты NVIDIA?
Да, но с оговорками. Есть режим генерации на CPU (флаг --use-cpu all), однако скорость будет крайне низкой — одно изображение может генерироваться десятки минут. Владельцам AMD реалистичнее вариант с Linux и ROCm либо специализированные форки под DirectML для Windows.
Куда скачивать модели для WebUI?
Чекпоинты в формате .safetensors помещаются в папку models/Stable-diffusion, файлы LoRA — в models/Lora, VAE — в models/VAE. После добавления файлов нажмите кнопку обновления рядом со списком моделей в интерфейсе.
WebUI не видит скачанную модель. Что проверить?
Убедитесь, что файл лежит именно в models/Stable-diffusion, а не во вложенной подпапке неправильного уровня, и что его расширение — .safetensors или .ckpt. Затем нажмите кнопку обновления списка моделей в интерфейсе или перезапустите WebUI. Также проверьте, что файл докачался полностью — оборванная загрузка даёт битый файл с правильным именем.
Как ускорить генерацию изображений?
Основные способы: установить оптимизацию xformers (флаг --xformers в COMMANDLINE_ARGS), снизить разрешение и количество шагов сэмплирования, использовать более быстрые сэмплеры. На картах с малым объёмом VRAM парадоксально помогает отказ от --lowvram, если памяти хватает без него — режимы экономии памяти замедляют работу.