AUTOMATIC1111 обычно ломается по четырём причинам: стартовый файл не находит подходящий Python, виртуальное окружение повреждено, порт занят прошлым процессом либо расширение конфликтует со связкой torch и xformers. Точная причина всегда напечатана в чёрном окне консоли, и читать надо последнюю строку.
Где на самом деле написана ошибка
AUTOMATIC1111 запускается стартовым файлом, который открывает консоль, готовит окружение и поднимает локальный сервер. Всё, что вы видите потом в браузере, это только витрина. Когда что-то ломается, витрина либо не открывается вовсе, либо выглядит нормально и молчит, а объяснение остаётся в консоли.
Поэтому первое действие всегда одно: не закрывать чёрное окно и прочитать его последние строки. Если оно захлопывается мгновенно, откройте терминал в папке проекта вручную и запустите стартовый файл оттуда. Окно останется на месте вместе с текстом ошибки. Это простое действие отсекает половину бессмысленных переустановок, потому что вместо гадания вы получаете конкретное имя пакета, файла или папки.
Второй ориентир это строка, в которой интерфейс сообщает, какое вычислительное устройство он использует. Если там оказался процессор вместо видеокарты, дальше искать нечего, вы уже нашли главную проблему, и она объясняет и медленную генерацию, и странные ошибки памяти. Если вы не уверены, что сборка изначально была установлена правильно, сверьтесь с нашей инструкцией про то, как проходит установка AUTOMATIC1111, прежде чем чинить то, что никогда не работало.
webui-user.bat открывается и сразу закрывается
Самая частая жалоба новичков. Окно мигает и исчезает, никакой информации не остаётся. Причина всегда в том, что скрипт дошёл до ошибки и завершился, а окно закрылось вместе с процессом. Запустите его из уже открытого терминала, и текст сохранится.
Python не найден или найден не тот
Скрипт ищет интерпретатор Python в системном пути. Если Python не установлен, установлен из магазина приложений или установлен без добавления в путь, скрипт до работы просто не доходит. Симптом в тексте прямой: сообщение о том, что команда не распознана.
Вторая разновидность этой же проблемы тоньше. Python установлен, но версия неподходящая, обычно слишком новая. Тогда установка зависимостей начинает собирать пакеты из исходников и падает на отсутствии компилятора. Решение не в установке компилятора, а в использовании версии, которую ожидает интерфейс. Путь к нужному интерпретатору указывается прямо в переменных внутри стартового файла, и это надёжнее, чем переустанавливать системный Python.
Повреждённое виртуальное окружение
Папка venv внутри проекта содержит собственную копию интерпретатора и все пакеты. Она ломается, если вы обновили или удалили системный Python, перенесли папку проекта в другое место или прервали установку на середине. Симптом узнаваемый: ошибки об отсутствии пакетов, которые вы точно устанавливали.
Лечение выглядит страшно, но безопасно: удалите папку venv и запустите стартовый файл заново. Он пересоздаст окружение и скачает зависимости с нуля. Модели, настройки, результаты и расширения в этой папке не лежат, терять нечего. Единственная плата это время на повторную загрузку пакетов.
Путь, антивирус и место на диске
Три бытовые причины, которые дают загадочные ошибки. Путь с кириллицей, пробелами или глубокой вложенностью ломает часть зависимостей, поэтому проект лучше держать в короткой папке на латинице ближе к корню диска. Антивирус умеет удалять файлы прямо во время установки, оставляя окружение наполовину собранным, и тогда установка падает каждый раз в новом месте. Нехватка места на диске даёт сообщения, которые указывают куда угодно, кроме реальной причины. Проверьте все три пункта до того, как разбирать зависимости по одной, это занимает минуту.
Сообщение о занятом порте
Текст про занятый адрес означает, что предыдущий сервер не завершился. Обычно так бывает, когда окно закрывают крестиком, а процесс остаётся жить в фоне. Иногда порт занимает совсем другая программа, и такое тоже встречается.
Решений два. Найти зависший процесс Python в диспетчере задач и завершить его, после чего запуск пройдёт нормально. Либо запустить интерфейс на другом порту через аргумент в стартовом файле. Второй способ быстрее, но не забудьте, что адрес в браузере тоже изменится, иначе вы откроете старую вкладку, увидите пустоту и решите, что ничего не помогло. Всегда сверяйте адрес с тем, который печатает консоль после успешного старта.
Ошибки xformers и torch
Эта пара отвечает за вычисления, и её несовместимость даёт самые пугающие на вид сообщения. Практически всегда причина в том, что один компонент обновился, а другой остался прежним.
Типичный сценарий: вы обновили интерфейс, он подтянул новую сборку вычислительной библиотеки, а ускоритель внимания остался от предыдущей и теперь ожидает другое окружение. Правильное лечение это переустановка связки целиком, а не отдельного пакета. Половинчатое обновление одного из компонентов приводит ровно к тому же состоянию через день.
Если разбираться некогда, есть рабочий обходной путь: запустить интерфейс без ускорителя внимания, отключив соответствующий аргумент в стартовом файле. Скорость немного снизится, расход видеопамяти вырастет, но генерация заработает. Это нормальное временное решение, к которому не стыдно прибегнуть, когда картинки нужны сегодня.
Отдельно про сообщения о том, что вычислительное устройство недоступно. Здесь виноват либо драйвер видеокарты, либо сборка вычислительной библиотеки без поддержки графического ускорителя. Обновите драйвер начисто и убедитесь, что установлена правильная сборка. Если карта старая и не поддерживается современными сборками, честный вывод такой: локально это не лечится, и вычисления надо выносить в другое место либо переходить на облегчённые модели, варианты собраны в материале про нейросети на слабом ПК.
Пока идёт разбирательство, задачу можно закрыть параллельно через генератор изображений в браузере, чтобы не терять день и не работать в спешке над отладкой.
Чёрное изображение вместо результата
Отдельный класс жалоб выглядит так: генерация проходит полностью, прогресс доходит до конца, ошибок в консоли нет, а на выходе пустой чёрный или однородный серый прямоугольник. Именно отсутствие ошибки сбивает с толку сильнее всего, потому что чинить вроде бы нечего.
Первая и самая частая причина: не подключён подходящий VAE. Часть чекпоинтов несёт его внутри себя, часть нет, и во втором случае этап декодирования выдаёт мусор. Подключите внешний VAE в настройках и повторите генерацию с тем же значением сида, разница будет очевидна сразу.
Вторая причина в режиме вычислений. На некоторых видеокартах половинная точность вызывает переполнение при декодировании, и картинка выходит пустой. Запуск с принудительной полной точностью через аргумент в стартовом файле решает вопрос ценой скорости и повышенного расхода памяти. Это классическая ситуация, когда правильная настройка выглядит как ухудшение производительности, но без неё результата нет вообще.
Третья причина в параметрах. Слишком высокое значение CFG вместе с малым числом шагов выжигает изображение в равномерное пятно, а перегруженный негативный промпт способен вычистить из кадра практически всё содержимое. Верните параметры к умеренным значениям, отключите половину негативных описаний и проверьте снова. Если результат появился, дальше подбирайте баланс постепенно, меняя по одному параметру за раз.
Конфликты расширений
У AUTOMATIC1111 огромная экосистема расширений, и она же главный источник нестабильности. Расширение подгружается при старте, встраивается в интерфейс и тянет собственные зависимости. Когда два расширения хотят разные версии одной библиотеки, выигрывает установленное последним, а ломается обычно другое.
Как быстро найти виновника
Если интерфейс перестал запускаться после установки расширения, начинайте с него, а не с зависимостей. Запустите интерфейс с отключёнными расширениями, если такой режим доступен, либо просто переименуйте папку расширений целиком и проверьте старт. Поднялся значит виновник внутри. Дальше возвращайте расширения обратно половинами, перезапуская каждый раз, и вы находите нужное за несколько шагов вместо перебора всего списка.
Что делать с найденным виновником
Вариантов три. Обновить расширение, потому что автор мог уже выпустить совместимую версию. Откатить его на предыдущее состояние, если обновление сломало рабочую сборку. Или отказаться от него совсем, если функция не критична. Многие популярные задачи решаются штатными средствами: доработка деталей описана в материале про inpaint и дорисовку, увеличение размера в разборе апскейла изображений, а исправление лиц и рук в гайде по ADetailer. Иногда выясняется, что расширение вам и не нужно было.
Таблица быстрой диагностики
| Симптом | Вероятная причина | Первое действие |
|---|---|---|
| Окно мигает и закрывается | Ошибка на старте, текст не успевает прочитаться | Запустить стартовый файл из открытого терминала |
| Команда не распознана | Python не установлен или не в системном пути | Указать путь к нужному интерпретатору в стартовом файле |
| Пакеты не найдены | Повреждённое виртуальное окружение | Удалить папку venv и перезапустить |
| Сообщение о занятом адресе | Старый процесс не завершён | Закрыть процесс Python или сменить порт |
| Ошибки xformers или torch | Компоненты обновились не синхронно | Переустановить связку, временно отключить ускоритель |
| Сбой сразу после установки расширения | Конфликт зависимостей | Переименовать папку расширений и проверить старт |
| Интерфейс открывается пустым | Кеш браузера или сломанная разметка расширением | Обновить страницу с очисткой кеша |
| Ошибка нехватки памяти | Модель не помещается в VRAM | Снизить разрешение, включить экономный режим |
Интерфейс открылся, но пустой или не отвечает
Белая страница или интерфейс без элементов почти никогда не связаны с моделями. Это проблема отображения, и она разбирается быстро.
Начните с обновления страницы с принудительной очисткой кеша, потому что браузер часто держит старые скрипты после обновления интерфейса. Затем отключите дополнения браузера, включая блокировщики рекламы, они периодически режут локальные скрипты. Дальше проверьте расширения самого интерфейса, поскольку сломанное расширение может испортить разметку, не выдав ни одной ошибки в консоли. И наконец сверьте адрес: если сервер поднялся на другом порту, вы просто смотрите не туда.
Отдельный случай это бесконечная загрузка при старте. Обычно интерфейс в этот момент скачивает недостающие компоненты, и при медленной или нестабильной сети это выглядит как зависание. Посмотрите в консоль: если там идёт активность, программа работает, просто ждёт. Если активности нет несколько минут подряд, перезапускайте.
Модели не появляются в списке
Пустой выпадающий список чекпоинтов выглядит как серьёзная поломка, а чинится почти всегда за минуту. Проверяйте по порядку, не перескакивая через пункты.
Файл должен лежать именно в каталоге чекпоинтов, а не рядом с ним и не во вложенной папке, которую создал архиватор при распаковке. Это причина примерно половины случаев, и она же самая обидная. Откройте папку и посмотрите глазами, а не по памяти.
Файл должен быть скачан целиком. Оборванная загрузка даёт файл заметно меньше заявленного, и он либо не появляется в списке, либо выбирается и роняет генерацию ошибкой чтения. Сравните размер с тем, что указан на странице загрузки. Если автор опубликовал контрольную сумму, сверьте её, это единственный надёжный способ отличить целый файл от повреждённого, не запуская генерацию.
Файл должен быть именно чекпоинтом. LoRA, эмбеддинги, модели апскейла и VAE лежат в собственных каталогах, и положенные не туда они просто не отображаются нигде. Ошибка распространённая, потому что все эти файлы внешне похожи и часто скачиваются из одного места подряд.
И последнее: список моделей перечитывается не всегда автоматически. Нажмите кнопку обновления рядом со списком, а если и это не сработало, перезапустите сервер. Если каталог моделей у вас общий для нескольких интерфейсов и подключён через настройку путей, проверяйте именно её, потому что она важнее физического расположения файлов и одна опечатка обнуляет весь список.
Работает, но вылетает или тормозит
Вылет посреди генерации почти всегда означает нехватку видеопамяти. Уменьшите разрешение, отключите апскейл в том же проходе, уберите лишние вспомогательные модели и закройте приложения, которые тоже используют видеокарту. Помогают и штатные аргументы экономии памяти, они замедляют работу, но дают довести задачу до конца.
Постоянная низкая скорость при формально исправной работе обычно объясняется одним из двух. Либо расчёт идёт на процессоре, что видно в строке при старте. Либо видеопамять заполнена почти под завязку, и драйвер начинает перекладывать данные в оперативную память, отчего скорость падает в разы. Второй случай коварен тем, что ошибок нет, всё работает, просто мучительно долго. Обучение собственных моделей на такой конфигурации лучше отложить, требования к железу разобраны в руководстве по обучению LoRA.
Когда проще сменить интерфейс
Есть момент, после которого починка перестаёт окупаться. Если вы каждую неделю тратите вечер на конфликты зависимостей, а генерируете раз в месяц, инструмент выбран неудачно. AUTOMATIC1111 ценен зрелой экосистемой и огромным количеством расширений, но платой за это является хрупкость сборки.
Альтернативы существуют и решают ровно эту боль. Forge оптимизирован под экономию видеопамяти и запускается на более скромном железе, порядок установки описан в материале про установку Forge. Полное сравнение подходов с их сильными и слабыми сторонами есть в разборе ComfyUI против Forge и A1111. Смена интерфейса это не капитуляция, а нормальное инженерное решение, когда стоимость обслуживания превышает пользу. А если результат нужен прямо сейчас и без установки, его даст онлайн-сервис генерации.
Порядок действий, если ничего не помогло
Когда очевидные шаги пройдены, а сборка всё ещё не работает, переходите к методичной проверке. Соберите три факта: последнюю строку ошибки целиком, строку об используемом устройстве при старте и последнее изменение, которое вы вносили перед появлением проблемы. Почти всегда виновато именно последнее изменение, а не случайность.
Дальше проверьте минимальный сценарий. Один базовый чекпоинт, небольшое разрешение, умеренное число шагов, все расширения отключены, никаких дополнительных модулей в проходе. Если минимальный сценарий работает, поломка в ваших настройках или расширениях, и её найдёт последовательное включение элементов по одному. Если не работает даже он, проблема глубже, в окружении или в железе, и разбирать надо именно там.
Чистую установку делайте в отдельную папку рядом со старой, а не поверх неё. Модели подключите через общий каталог, чтобы не копировать гигабайты дважды. Старая папка останется страховкой и источником настроек, а сравнение поведения двух сборок на одной модели часто мгновенно указывает на виновника. Переустановка поверх лишает вас обеих возможностей и превращает диагностику в угадывание.
И последний совет, который экономит больше всего времени: заведите привычку копировать рабочую папку перед крупными изменениями. Не всю, достаточно конфигурации, списка расширений и стартового файла. Тогда любая неудачная попытка отката занимает минуту, а не вечер, и вы перестаёте бояться экспериментов с настройками.
Часто задаваемые вопросы
Почему webui-user.bat закрывается сразу после запуска?
Скрипт дошёл до ошибки и завершился, а окно исчезло вместе с процессом. Откройте терминал в папке проекта и запустите стартовый файл оттуда, тогда текст останется на экране. Чаще всего вы увидите одно из трёх: Python не найден в системном пути, повреждено виртуальное окружение или не хватает места на диске.
Можно ли удалять папку venv?
Да, это штатное действие при проблемах с зависимостями. В ней хранится только копия интерпретатора и установленные пакеты, а модели, настройки, расширения и результаты лежат в других местах. После удаления стартовый файл пересоздаст окружение автоматически и заново скачает всё необходимое. Единственная плата это время на загрузку пакетов, никаких данных вы не потеряете.
Что делать при сообщении о занятом порте?
Завершите зависший процесс Python в диспетчере задач, обычно он остаётся после закрытия окна крестиком. Если это не помогает, значит порт занят другой программой, и проще запустить интерфейс на другом порту через аргумент в стартовом файле. После смены порта обязательно откройте новый адрес, который печатает консоль, а не старую вкладку в браузере.
Как понять, какое расширение сломало интерфейс?
Переименуйте папку расширений целиком и проверьте, запускается ли интерфейс. Если да, виновник внутри. Верните имя обратно и возвращайте расширения половинами, перезапуская после каждого шага, так вы находите нужное за несколько итераций. Многие интерфейсы также умеют стартовать в режиме без расширений, что делает первую проверку ещё быстрее.
Нужно ли вообще устанавливать xformers?
Нет, это ускоритель, а не обязательный компонент. Он экономит видеопамять и повышает скорость, но при несовместимости версий становится источником ошибок. Если сборка ломается именно на нём, отключите его аргументом в стартовом файле и работайте дальше. Потеря скорости заметна, но умеренна, а стабильность обычно важнее нескольких процентов производительности.
Почему интерфейс работает на процессоре, а не на видеокарте?
Так бывает, когда установлена сборка вычислительной библиотеки без поддержки графического ускорителя либо драйвер видеокарты устарел. Посмотрите строку об используемом устройстве при старте, там всё написано прямо. Переустановите нужную сборку и обновите драйвер начисто. Для очень старых карт и встроенной графики поддержки может не быть в принципе, тогда локальный запуск смысла не имеет.
Помогает ли обновление интерфейса, если он не работает?
Иногда помогает, но с той же вероятностью ломает что-то ещё, потому что расширения обычно отстают от ядра. Сначала прочитайте ошибку и попробуйте адресное решение. Обновляйтесь осознанно, сделав перед этим копию рабочей папки, тогда любое обновление становится обратимым и вы всегда можете вернуться к состоянию, которое точно работало.
Стоит ли переходить на Forge, если A1111 постоянно ломается?
Если вы тратите на обслуживание больше времени, чем на генерацию, переход оправдан. Forge экономнее расходует видеопамять и стабильнее ведёт себя на скромном железе, а привычный вид интерфейса сохраняется, так что переучиваться почти не придётся. Модели можно подключить через общий каталог и не копировать файлы, а старую сборку оставить на месте для сравнения.
