Руководство по установке ComfyUI на Linux

⚠️ Важное уведомление: Шаги установки могут меняться по мере развития ComfyUI. Для получения самой актуальной информации всегда обращайтесь к официальному репозиторию. Это руководство отражает текущие лучшие практики по состоянию на середину 2025 года.

ℹ️ Примечание об обновлениях: Для получения самой актуальной информации об установке Desktop версии проверьте официальную документацию.

Существует два способа установки ComfyUI на Linux:

1. Comfy CLI (рекомендуется) — официальный инструмент командной строки для простой установки
2. Ручная установка — полный контроль над окружением

Comfy Desktop: Linux официально не поддерживается в настоящее время. Следите за обновлениями в официальной документации.

Системные требования

• Python 3.12 или 3.13 (рекомендуется 3.13)
• NVIDIA GPU с поддержкой CUDA, рекомендуется 4 ГБ+ VRAM
• AMD GPU — поддержка ROCm 7.2 (только Linux)
• Intel GPU — серия Arc через нативный PyTorch torch.xpu
• ОЗУ: минимум 8 ГБ, рекомендуется 16 ГБ
• Накопитель: SSD с минимум 20 ГБ свободного места (абсолютный минимум — модели для типовых рабочих процессов могут легко занимать 50–100 ГБ+)

Comfy CLI (рекомендуется)

Comfy CLI — это официальный инструмент командной строки, который упрощает установку и управление.

Шаг 1: Проверка окружения Python

Убедитесь, что установлен Python 3.12 или 3.13:

python3 --version

Если Python не установлен или версия слишком старая:

sudo pacman -S python python-pip

Шаг 2: Установка Comfy CLI

pip install comfy-cli

Шаг 3: Установка ComfyUI

comfy install

Эта команда загружает и настраивает ComfyUI с настройками по умолчанию. Для получения дополнительных параметров см. Полное руководство по Comfy CLI.

Шаг 4: Запуск ComfyUI

comfy launch

Откройте в браузере http://127.0.0.1:8188.

Метод 3: Ручная установка

Шаг 1: Установка зависимостей

Установите системные зависимости:

# Ubuntu/Debian
sudo apt update
sudo apt install git python3 python3-pip python3-venv -y

# Установка зависимостей для NVIDIA GPU
# Убедитесь, что установлены драйвер NVIDIA и CUDA Toolkit

Шаг 2: Клонирование репозитория

git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI

Шаг 3: Создание виртуального окружения

python3 -m venv .venv
source .venv/bin/activate

Шаг 4: Установка GPU и зависимостей ComfyUI

# Установка PyTorch с CUDA 13.0
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

# Установка зависимостей ComfyUI
pip install -r requirements.txt

# Установка PyTorch с поддержкой ROCm
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm7.2

# Установка зависимостей ComfyUI
pip install -r requirements.txt

# Установка PyTorch с поддержкой Intel GPU
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

# Поддержка Intel Arc требует дополнительной настройки
# См.: https://github.com/comfyanonymous/ComfyUI?tab=readme-ov-file#manual-install-windows-linux

Шаг 5: Запуск ComfyUI

python main.py

Для AMD GPU или режима только CPU:

python main.py --cpu

Дополнительные параметры запуска см. в руководстве Флаги запуска ComfyUI.

Шаг 6: Доступ к интерфейсу

Откройте браузер и перейдите по адресу http://127.0.0.1:8188.

Следующие шаги

• Установка моделей — добавьте checkpoint-модели, LoRA и т.д.
• Установка пользовательских узлов — расширьте функциональность ComfyUI
• Руководство по интерфейсу ComfyUI — изучите основы интерфейса