Где находится папка моделей ComfyUI? Встроенные и дополнительные пути
Для переносной или ручной установки ComfyUI встроенная библиотека моделей — ComfyUI/models/. Поместите каждый файл в подпапку своего типа: чекпойнты в models/checkpoints, LoRAs в models/loras, VAEs в models/vae. Если файлы уже находятся в общей библиотеке, добавьте её как дополнительный путь моделей вместо создания ещё одной полной копии.
Встроенная папка моделей ComfyUI
ComfyUI не считает models единой неразличимой корзиной. Загрузчики ищут в зарегистрированных папках соответствующего типа модели. Встроенная папка LoRA ComfyUI — ComfyUI/models/loras. Помещённый туда чекпойнт остаётся чекпойнтом; расположение не меняет содержимое файла.
ComfyUI/
└── models/
├── checkpoints/ # полные диффузионные чекпойнты
├── diffusion_models/ # диффузионные веса или веса UNet
├── loras/ # LoRA и связанные файлы адаптеров
├── text_encoders/ # веса текстового кодировщика
├── vae/ # Модели VAE
└── controlnet/ # Модели ControlNet и адаптеров T2I
Текущий официальный пример конфигурации также распознаёт устаревшие имена unet и clip. Для новой аккуратной библиотеки предпочитайте современные имена выше. Другие типы узлов могут регистрировать дополнительные папки, поэтому пакет пользовательского узла способен добавить расположение модели, которого нет в этой краткой карте.
ComfyUI Desktop: откройте папку, а не угадывайте её
Установки Desktop легко понять неправильно, поскольку приложение управляет большей частью структуры. В ComfyUI Desktop используйте Help → Open Folder → Open Model Folder. Откроется активное расположение, что позволит не скопировать модель в одноимённую папку старой установки.
Это также самый быстрый способ диагностики, когда файл не появляется. Убедитесь, что смотрите папку моделей работающего приложения, а не первый каталог ComfyUI, найденный файловым поиском.
Когда дополнительные пути моделей — более чистое решение
Дополнительный путь полезен, когда две установки ComfyUI должны видеть одну библиотеку, когда файлами уже управляет другой интерфейс или большие модели находятся на другом диске. Он сообщает ComfyUI, где ещё искать, но не копирует, не преобразует, не объединяет и не создаёт резервную копию модели.
Неудобная деталь: переносная или ручная ComfyUI и ComfyUI Desktop используют разные имена файлов конфигурации:
- Переносная или ручная установка: скопируйте
ComfyUI/extra_model_paths.yaml.exampleвComfyUI/extra_model_paths.yaml, затем отредактируйте копию. - Desktop в Windows: отредактируйте
C:\Users\YourUsername\AppData\Roaming\ComfyUI\extra_models_config.yaml. - Desktop в macOS: отредактируйте
~/Library/Application Support/ComfyUI/extra_models_config.yaml.
Сохраняйте созданную Desktop запись. Официальное руководство Desktop предписывает добавить конфигурацию в существующий файл, а не заменять его. Сначала создайте резервную копию YAML; отступы являются частью синтаксиса.
Небольшая понятная конфигурация дополнительного пути
Начните с одной именованной библиотеки и только действительно общих типов моделей. base_path — родительский каталог; остальные значения — пути относительно него.
shared_models:
base_path: /Volumes/AI-Library/models/
checkpoints: checkpoints
loras: loras
vae: vae
controlnet: controlnet
text_encoders: text_encoders
diffusion_models: diffusion_models
В Windows используйте абсолютный путь Windows для base_path, например D:\AI-Library\models\. Сохраняйте реальные пробелы в пути; не добавляйте кавычки или экранирование, пока их не требует анализатор YAML. Самая простая конфигурация обычно та, которую можно напрямую сопоставить с папками на диске.
Перезапустите, обновите и подтвердите одну известную модель
Сохраните конфигурацию и перезапустите ComfyUI. В официальном руководстве по моделям также указано, что r обновляет определения узлов, но после изменения путей моделей перезапуск даёт более ясную проверку. Затем подтвердите настройку на узнаваемых файлах:
- Выберите один известный чекпойнт и одну известную LoRA из внешней библиотеки.
- Убедитесь, что каждый файл появляется в подходящем загрузчике, а не просто где-то в интерфейсе.
- Загрузите небольшой существующий рабочий процесс и убедитесь, что оба файла действительно открываются.
- Не изменяйте исходное расположение, пока проверка не пройдёт после нового перезапуска.
Если модель отсутствует, по порядку проверьте активную папку моделей, отступы YAML, base_path, подпапку типа и расширение файла. Успешный разбор YAML не доказывает, что чекпойнт помещён как чекпойнт.
Дополнительный путь — не план хранения
Общий каталог позволяет избежать дублирующихся рабочих копий, но остаётся активным хранилищем среды. Удаление из него может затронуть все установки ComfyUI, которые на него ссылаются. Точно так же файл SafeTensors не становится резервной копией лишь потому, что его видят два приложения.
Tensor Archive используется после решения вопроса среды. Определите завершённое связанное семейство, например базовый чекпойнт с адаптерами, а затем отдельно заархивируйте, проверьте и восстановите его. Tensor Archive не переписывает конфигурацию ComfyUI и не удаляет исходную папку незаметно.
Выберите следующее руководство по реальной проблеме
Если нужно сохранить рабочий процесс со встроенными и дополнительными путями, используйте руководство по резервному копированию моделей ComfyUI. Если SSD уже заполнен адаптерами, следуйте практическому руководству по освобождению места в библиотеке LoRA. Различия методов обучения и создаваемых адаптеров описаны в материале LoRA и QLoRA.
Источники
- Документация ComfyUI: модели — встроенные папки моделей, расположения Desktop, настройка дополнительных путей и устранение неполадок.
- ComfyUI: extra_model_paths.yaml.example — актуальные ключи и структура конфигурации переносной или ручной установки.
- ComfyUI: folder_paths.py — текущие стандартные регистрации папок и устаревшие псевдонимы.
- Документация ComfyUI: загрузка LoRA — документированное встроенное расположение файлов LoRA.