Клонирование репозитория Stable Diffusion с GitHub часто заканчивается ошибкой Python not found или конфликтом версий PyTorch ещё до первого запуска — причина почти всегда в несоответствии окружения требованиям конкретной сборки. Проверьте версию Python командой python --version в терминале: большинство веб-интерфейсов требуют строго определённую ветку (например, Python 3.10 для AUTOMATIC1111), и лишняя версия в системе ломает установку зависимостей.
В этой статье разберём, какие репозитории Stable Diffusion существуют на GitHub, чем они отличаются, как правильно скачать и установить проект, а также какие ошибки встречаются чаще всего и как их диагностировать без риска для системы.
Какие репозитории Stable Diffusion есть на GitHub
Запрос «stable diffusion github» обычно ведёт к нескольким разным проектам, и важно не перепутать их назначение. Официальный репозиторий CompVis/stable-diffusion — это исходный исследовательский код модели, ориентированный на разработчиков и работу из командной строки. Он не содержит удобного графического интерфейса.
Для практической генерации изображений чаще используются производные проекты:
- 🖥️ AUTOMATIC1111 / stable-diffusion-webui — самый популярный веб-интерфейс с поддержкой расширений;
- 🧩 ComfyUI — узловой (node-based) интерфейс для гибких пайплайнов генерации;
- 🚀 Stability-AI / generative-models — официальный репозиторий Stability AI с новыми моделями, включая SDXL;
- 🔧 Forge, Fooocus и другие форки — альтернативные интерфейсы с упором на скорость или простоту.
Перед клонированием проверьте активность репозитория: дату последнего коммита, количество открытых issues и наличие раздела README с инструкцией. Заброшенный форк может не поддерживать актуальные версии зависимостей.
Что нужно перед установкой
Установка Stable Diffusion из GitHub требует подготовленного окружения. Если пропустить этот этап, скрипт установки завершится с ошибкой на полпути, и диагностика станет сложнее.
Минимальный набор компонентов, который необходимо проверить:
- 🐍 Python версии, указанной в README репозитория (для AUTOMATIC1111 обычно требуется 3.10.x);
- 📦 Git для клонирования репозитория и обновлений;
- 🎮 Видеокарта с поддержкой CUDA (для NVIDIA) — без неё генерация возможна только на CPU и идёт очень медленно;
- 💾 Свободное место на диске: модели занимают от 2 до 7 ГБ каждая, плюс зависимости.
⚠️ Внимание: устанавливайте Python только с официального сайта python.org и при установке отметьте опцию Add Python to PATH. Сборки из Microsoft Store часто вызывают конфликты путей при работе с виртуальными окружениями Stable Diffusion.
Пошаговая установка AUTOMATIC1111 из GitHub
Наиболее частый сценарий — установка stable-diffusion-webui. Порядок действий на Windows выглядит так. Сначала клонируйте репозиторий в папку без кириллицы и пробелов в пути:
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.gitЗатем запустите файл webui-user.bat двойным кликом. При первом запуске скрипт сам создаст виртуальное окружение и скачает зависимости — это может занять продолжительное время в зависимости от скорости сети. Не закрывайте окно терминала, пока идёт установка.
После завершения установки вам нужно поместить файл модели (например, в формате .safetensors) в папку models/Stable-diffusion. Без модели интерфейс запустится, но генерация будет невозможна.
☑️ Проверка перед первым запуском
Когда всё готово, интерфейс откроется по адресу http://127.0.0.1:7860 в браузере. Если порт занят, его можно изменить параметром --port в файле webui-user.bat.
Типичные ошибки при установке и их причины
Большинство проблем при развёртывании Stable Diffusion из GitHub сводится к нескольким повторяющимся сценариям. Ниже — таблица частых ошибок и способов диагностики.
| Ошибка | Вероятная причина | Что проверить |
|---|---|---|
| Python is not recognized | Python не добавлен в PATH | Переустановить Python с опцией Add to PATH |
| Ошибка при установке torch | Несовместимая версия Python | Убедиться, что используется нужная версия (3.10.x) |
| CUDA out of memory | Недостаточно видеопамяти | Добавить флаг --medvram или --lowvram |
| Git command not found | Git не установлен | Установить Git и перезапустить терминал |
| Конфликт зависимостей pip | Битое виртуальное окружение | Удалить папку venv и запустить установку заново |
Отдельно стоит упомянуть ошибку «Torch is not able to use GPU» — она означает, что PyTorch установился в CPU-версии. Обычно это происходит из-за устаревших драйверов NVIDIA или прерванной установки. Лечится удалением папки venv и повторным запуском после обновления драйверов.
⚠️ Внимание: не скачивайте «готовые сборки» Stable Diffusion с посторонних сайтов и файлообменников — в такие архивы нередко встраивают вредоносный код. Единственный безопасный источник — официальные репозитории на GitHub и проверенные страницы моделей.
Обновление и работа с расширениями
Одно из преимуществ установки через Git — простое обновление. Достаточно выполнить в папке проекта команду:
git pullПосле обновления веб-интерфейс при следующем запуске сам подтянет изменённые зависимости. Если после git pull проект перестал запускаться, возможная причина — конфликт локальных правок с обновлением; в этом случае проверьте вывод git status на наличие изменённых файлов.
Расширения (extensions) устанавливаются прямо из вкладки Extensions в интерфейсе — по сути, это тоже клонирование репозиториев с GitHub в папку extensions. Перед установкой расширения проверяйте его репозиторий: дату последнего обновления и отзывы в issues. Устаревшие расширения — частая причина падения интерфейса после обновления ядра.
Что делать, если интерфейс упал после установки расширения
Переименуйте или удалите папку проблемного расширения в каталоге extensions и перезапустите webui-user.bat. Если интерфейс запустился — причина подтверждена. Затем проверьте issues репозитория расширения: возможно, уже есть исправление или указание на несовместимость с вашей версией.
Где брать модели и как проверять файлы
Сам репозиторий Stable Diffusion на GitHub не содержит обученных весов — их нужно скачивать отдельно. Модели распространяются в форматах .ckpt и .safetensors. Предпочтительнее safetensors: этот формат не исполняет код при загрузке, тогда как .ckpt основан на pickle и теоретически может содержать вредоносные инструкции.
После скачивания файл помещается в папку models/Stable-diffusion, после чего модель появляется в выпадающем списке интерфейса. Если модель не отображается — нажмите кнопку обновления списка рядом с выпадающим меню или перезапустите интерфейс.
FAQ: частые вопросы о Stable Diffusion и GitHub
Можно ли использовать Stable Diffusion без видеокарты NVIDIA?
Да, возможна генерация на CPU или на картах AMD (через DirectML или ROCm, в зависимости от системы), но скорость будет заметно ниже. Для CPU-режима добавьте флаг --skip-torch-cuda-test --use-cpu all в параметры запуска, но будьте готовы к длительному времени генерации одного изображения.
Чем stable-diffusion-webui отличается от ComfyUI?
AUTOMATIC1111 WebUI — классический интерфейс с вкладками и формами, проще для новичков. ComfyUI строит генерацию как граф из узлов, что даёт больше контроля над пайплайном, но требует понимания структуры процесса. Оба проекта доступны на GitHub и бесплатны.
Безопасно ли скачивать репозитории с GitHub?
Сами по себе официальные репозитории безопасны, но важно проверять адрес: клонировать только из аккаунтов AUTOMATIC1111, CompVis, Stability-AI или comfyanonymous. Форки с похожими названиями от неизвестных авторов могут содержать изменённый код.
Почему установка зависает на скачивании зависимостей?
Возможные причины: медленное соединение, блокировка доступа к серверам PyPI или Hugging Face, либо антивирус, проверяющий большие файлы. Проверьте, не блокирует ли сетевой экран трафик, и попробуйте повторить установку позже — прерванная установка возобновляется повторным запуском webui-user.bat.
Нужно ли заново устанавливать всё после обновления через git pull?
Нет, обновление затрагивает только код проекта. Ваши модели, настройки и сгенерированные изображения остаются на месте. Зависимости при необходимости обновятся автоматически при следующем запуске.