Skip to content
ComfyUI Wiki
Помогите создать лучшую базу знаний ComfyUI Стать спонсором

Как установить ComfyUI на Linux

Есть два основных способа установки ComfyUI на Linux:

  1. Установка с использованием Comfy CLI (Рекомендуется) - Самый простой и быстрый метод
  2. Установка из исходного кода ComfyUI - Традиционный метод ручной установки

Этот учебник подробно охватит оба метода установки, с акцентом на рекомендацию установки Comfy CLI.

Метод 1: Установка ComfyUI с использованием Comfy CLI (Рекомендуется)

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

Шаг 1: Подготовка системной среды

1. Обеспечение среды Python

ComfyUI требует Python 3.9 или выше. Проверьте версию Python:

python3 --version 

Если Python не установлен или версия слишком низкая, установите его, следуя этим шагам:

Системы Ubuntu/Debian:

sudo apt update
sudo apt install python3 python3-pip python3-venv

Системы CentOS/RHEL/Fedora:

# CentOS/RHEL
sudo yum install python3 python3-pip
# Или Fedora
sudo dnf install python3 python3-pip

Arch Linux:

sudo pacman -S python python-pip

2. Установка Git (если не установлен)

# Ubuntu/Debian
sudo apt install git
 
# CentOS/RHEL
sudo yum install git
 
# Fedora
sudo dnf install git
 
# Arch Linux
sudo pacman -S git

3. Создание виртуальной среды (Рекомендуется)

Использование виртуальной среды может избежать проблем с конфликтами пакетов:

# Создать виртуальную среду с именем comfy-env
python3 -m venv comfy-env
 
# Активировать виртуальную среду
source comfy-env/bin/activate

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

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

Установите comfy-cli в активированной виртуальной среде:

pip install comfy-cli

Настройка автодополнения командной строки (Опционально)

Для получения лучшего пользовательского опыта вы можете включить автодополнение командной строки:

comfy --install-completion

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

Установка ComfyUI с comfy-cli очень проста, требует всего одну команду:

comfy install

Эта команда будет:

  • Скачивать и устанавливать последнюю версию ComfyUI
  • Автоматически устанавливать ComfyUI-Manager (менеджер узлов)
  • Настраивать базовую структуру проекта

Опции установки

Вы можете использовать следующие опции для настройки установки:

# Установить в место по умолчанию ~/comfy
comfy install
 
# Установить в указанную директорию
comfy --workspace=/path/to/your/workspace install
 
# Операции на существующем ComfyUI в текущей директории (в основном для обновлений)
comfy --here install
 
# Операции на наиболее недавно выполненном или установленном ComfyUI
comfy --recent install
 
# Установить только ComfyUI, без ComfyUI-Manager
comfy install --skip-manager

Проверка пути установки

Вы можете использовать следующие команды для проверки текущего рабочего пространства:

# Проверить рабочее пространство по умолчанию
comfy which
 
# Проверить рабочее пространство для указанных опций
comfy --recent which
comfy --here which

Шаг 4: Установка поддержки GPU

NVIDIA GPU (CUDA)

Если вы используете GPU NVIDIA, вам нужно установить поддержку CUDA:

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

Примечание: Пожалуйста, выберите соответствующую версию PyTorch на основе вашей версии CUDA. Посетите сайт PyTorch для получения последних команд установки.

AMD GPU (ROCm)

Если вы используете GPU AMD:

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

Только CPU

Если запуск только с CPU:

# Установить версию PyTorch для CPU
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu

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

После завершения установки запустите ComfyUI:

comfy launch

По умолчанию ComfyUI будет работать на http://localhost:8188.

Общие опции запуска

# Запуск в фоне
comfy launch --background
 
# Указать адрес прослушивания и порт
comfy launch -- --listen 0.0.0.0 --port 8080
 
# Использовать режим CPU
comfy launch -- --cpu

Метод 2: Установка из исходного кода ComfyUI

Если вы предпочитаете традиционный метод установки, вы также можете установить напрямую из исходного кода:

1. Клонирование репозитория ComfyUI

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

2. Создание виртуальной среды

python3 -m venv venv
source venv/bin/activate

3. Установка зависимостей

pip install -r requirements.txt

4. Установка поддержки GPU

Установите соответствующую версию PyTorch на основе вашего типа GPU (см. шаги выше).

5. Запуск ComfyUI

python main.py

Послеустановленная настройка

Установка базовых моделей

ComfyUI требует базовые модели для корректной работы. Вы можете:

  1. Скачать модели с Hugging Face
  2. Поместите файлы моделей в директорию models/checkpoints/
  3. Скачайте с помощью comfy-cli:
comfy model download --url https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned.safetensors --relative-path models/checkpoints

Устранение неполадок

Распространенные проблемы

1. Проблемы с разрешениями

Если вы столкнетесь с проблемами разрешений, убедитесь, что у вас достаточно прав для записи в директорию установки:

# Если используется директория по умолчанию, убедитесь, что директория ~/comfy доступна для записи
ls -la ~/comfy

2. Проблемы с версией Python

Убедитесь, что вы используете правильную версию Python:

python3 --version  # Должно быть 3.9 или выше

3. Проблемы с сетевым подключением

Если загрузки медленные, попробуйте использовать домашнюю зеркальную страницу:

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple comfy-cli

4. Проблемы с обнаружением GPU

Проверьте, правильно ли распознан GPU:

import torch
print(torch.cuda.is_available())  # NVIDIA GPU
print(torch.version.cuda)         # Версия CUDA

Итог

Использование Comfy CLI - лучший способ установки ComfyUI на Linux, предлагая:

  • Простой процесс установки: Полная установка с одной командой
  • Полное управление зависимостями: Автоматически обрабатывает все зависимости
  • Мульти-рабочие пространства: Может управлять несколькими экземплярами ComfyUI
  • Кросс-платформенная совместимость: Работает корректно на Windows, macOS и Linux

Если вы новичок в ComfyUI, мы настоятельно рекомендуем использовать Comfy CLI для установки и управления.

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

После установки вы можете:

Связанные ссылки