| --- |
| license: apache-2.0 |
| tags: |
| - comfyui |
| - runpod |
| - faceswap |
| --- |
| |
| # ComfyUI FaceSwap — готовый темплейт для RunPod |
|
|
| Поднимает на RunPod полностью настроенный ComfyUI с пайплайном замены лица: |
|
|
| 1. **Flux.2 Klein 9b** — переносит голову с одного фото на другое, сохраняя свет, ракурс и пропорции |
| 2. **Z-Image Turbo + FaceDetailer** — заново отрисовывает лицо в высоком разрешении, сюда подключается персональная LoRA |
|
|
| Оба этапа работают в связке и оба обязательны. Flux хорошо ставит голову по свету и ракурсу, но лицо у него выходит лишь похожим. Z-Image затем вырезает это лицо и рисует его заново — уже с обученной на конкретном человеке LoRA. Отсюда и настоящее сходство. |
|
|
| Ничего устанавливать руками не нужно. Один раз создаёшь темплейт — дальше запуск в два клика. |
|
|
| **Железо:** рассчитано на L40S (48 ГБ VRAM). Минимум — 24 ГБ VRAM и 32 ГБ RAM. |
|
|
| --- |
|
|
| ## Что нужно иметь |
|
|
| - аккаунт на [RunPod](https://runpod.io) с пополненным балансом |
| - аккаунт на [HuggingFace](https://huggingface.co) — бесплатный |
|
|
| --- |
|
|
| ## Шаг 1. Токен HuggingFace |
|
|
| Нужен, чтобы скачать модель Flux. Свой, личный — чужие токены не используй. |
|
|
| 1. Открой https://huggingface.co/settings/tokens |
| 2. **Create new token** |
| 3. Тип — **Read** (не Write) |
| 4. Название любое, например `runpod` |
| 5. **Create token** → скопируй и сохрани в блокнот |
|
|
| HuggingFace показывает токен только один раз. Потеряешь — сделаешь новый, ничего страшного. |
|
|
| --- |
|
|
| ## Шаг 2. Принять лицензию Flux |
|
|
| 1. Открой https://huggingface.co/black-forest-labs/FLUX.2-klein-9b-fp8 |
| 2. Убедись, что залогинен |
| 3. Нажми **Agree** на серой плашке |
|
|
| Выбирать там нечего, полей нет — просто кнопка. |
|
|
| > ⚠️ У FLUX.2 Klein **некоммерческая лицензия**. Использование результатов в коммерческих целях она не разрешает. Это твоя зона ответственности. |
| > |
| > Обойти этот шаг и всё равно пользоваться воркфлоу не получится: Flux здесь делает первый этап, без него замена лица не работает. Переключатель `WANT_FLUX=0` из таблицы настроек существует для тех, кто собирает что-то своё только на Z-Image — для этого воркфлоу его выключать нельзя. |
| |
| --- |
| |
| ## Шаг 3. Создать темплейт в RunPod |
| |
| Консоль RunPod → левое меню **Templates** → **New Template**. |
| |
| | Поле | Значение | |
| |---|---| |
| | Template Name | `ComfyUI-FaceSwap` | |
| | Template Type | `Pod` | |
| | Container Image | `runpod/pytorch:1.3.1-cu1300-torch291-ubuntu2404` | |
| | Container Disk | `20` GB | |
| | Volume Disk | `80` GB | |
| | Volume Mount Path | `/workspace` | |
| | Expose HTTP Ports | `8188,8888` | |
| | Expose TCP Ports | `22` | |
| |
| **Container Start Command** (в некоторых версиях поле называется Docker Command): |
| |
| ``` |
| bash -c "curl -sL https://huggingface.co/cocount21/comfy-faceswap-setup/resolve/main/provision.sh -o /provision.sh && bash /provision.sh 2>&1 | tee /workspace/provision.log" |
| ``` |
| |
| **Environment Variables** — добавь одну переменную: |
| |
| | Key | Value | |
| |---|---| |
| | `HF_TOKEN` | **оставь пустым** | |
|
|
| Пустым — потому что заполнять её ты будешь при запуске пода, своим токеном. Так она видна в форме деплоя и её не забудешь. |
|
|
| Нажми **Save Template**. |
|
|
| --- |
|
|
| ## Шаг 4. Запустить |
|
|
| 1. **Pods** → **Deploy** |
| 2. Выбери **L40S** |
| 3. **Change Template** → свой `ComfyUI-FaceSwap` |
| 4. В блоке Environment Variables впиши **свой** токен в `HF_TOKEN` |
| 5. **Deploy On-Demand** |
|
|
| --- |
|
|
| ## Шаг 5. Подождать |
|
|
| Первый запуск — 10–20 минут, качается около 40 ГБ моделей. ComfyUI стартует последним, раньше времени его дёргать бесполезно. |
|
|
| Смотреть прогресс: карточка пода → **Logs** → **Container Logs**. |
|
|
| В конце скрипт печатает отчёт: |
|
|
| ``` |
| =========================== SUMMARY =========================== |
| OK Flux-2-Klein-9b-fp8.safetensors |
| OK qwen_3_8b_fp8mixed.safetensors |
| ... |
| ================================================================= |
| time: 812 s |
| |
| ALL GOOD - ComfyUI is starting on port 8188 |
| ``` |
|
|
| Зелёное `ALL GOOD` — всё готово. Красные строки — смотри раздел «Если что-то пошло не так». |
|
|
| --- |
|
|
| ## Шаг 6. Работать |
|
|
| 1. Карточка пода → **Connect** → **HTTP Service → :8188** |
| 2. Воркфлоу уже загружен — в левой панели ComfyUI, раздел Workflows |
| 3. Загрузи две картинки: |
| - группа **Your-Image** — фото-основа: тело, поза, фон |
| - группа **Reference-Image** — лицо, которое переносим |
| 4. **Run** |
|
|
| Результат — в ноде **SaveImage** с жёлтой рамкой. Вторая SaveImage показывает промежуточный результат Flux, до починки лица. |
|
|
| ### Своя LoRA |
|
|
| Залей свою LoRA в любой публичный репозиторий на HuggingFace и при деплое добавь переменную: |
|
|
| ``` |
| EXTRA_LORAS = твой_ник/твой_репозиторий:имя_файла.safetensors |
| ``` |
|
|
| Несколько — через запятую. Файлы лягут в `models/loras/`, останется выбрать их в ноде. |
|
|
| --- |
|
|
| ## Настройки (Environment Variables) |
|
|
| | Переменная | По умолчанию | Что делает | |
| |---|---|---| |
| | `HF_TOKEN` | пусто | твой read-токен HuggingFace | |
| | `WANT_FLUX` | `1` | этап Flux.2 Klein, ~19 ГБ, gated, non-commercial. **Для этого воркфлоу выключать нельзя** | |
| | `WANT_ZIMAGE` | `1` | этап Z-Image Turbo, ~21 ГБ, Apache 2.0. **Для этого воркфлоу выключать нельзя** | |
| | `WANT_DETECTORS` | `1` | детекторы лица для FaceDetailer, ~0.4 ГБ. **Выключать нельзя** | |
| | `EXTRA_LORAS` | пусто | свои LoRA: `repo:file.safetensors`, через запятую | |
| | `GET_WORKFLOWS` | `1` | подтянуть воркфлоу автоматически | |
| | `START_JUPYTER` | `0` | поднять JupyterLab на порту 8888 | |
| | `SKIP_MODELS` | `0` | только ноды, без моделей — для быстрой проверки | |
| | `COMFY_PORT` | `8188` | порт ComfyUI | |
| | `COMFY_REF` | пусто | закрепить ComfyUI на конкретном коммите | |
|
|
| --- |
|
|
| ## Если что-то пошло не так |
|
|
| Скрипт проверяет доступ к Flux **до** скачивания и объясняет проблему прямо в логе. |
|
|
| | В логе | Причина | Решение | |
| |---|---|---| |
| | `HTTP 401` | токен неверный или пустой | сделать Read-токен, вписать в `HF_TOKEN` | |
| | `HTTP 403` | лицензия не принята | нажать Agree на странице модели | |
| | `BAD SIZE` | файл скачался битым | перезапустить под, скрипт перекачает сам | |
| | `TORCH CHANGED` | нода подменила torch | сообщи автору темплейта | |
| | `NODE MISSING` | не склонировалась нода | перезапустить под | |
|
|
| Полный лог лежит в поде: `/workspace/provision.log` |
|
|
| --- |
|
|
| ## Что внутри |
|
|
| **Ноды:** ComfyUI-Manager, Impact-Pack, Impact-Subpack, Easy-Use, rgthree-comfy, utils-nodes |
|
|
| **Модели:** |
|
|
| | Файл | Размер | Лицензия | |
| |---|---|---| |
| | Flux-2-Klein-9b-fp8 | 8.8 ГБ | FLUX Non-Commercial | |
| | qwen_3_8b_fp8mixed | 8.1 ГБ | — | |
| | flux2-vae | 0.3 ГБ | — | |
| | bfs_head_v1 (LoRA свапа) | 0.6 ГБ | не указана автором | |
| | z_image_turbo_bf16 | 11.5 ГБ | Apache 2.0 | |
| | qwen_3_4b | 7.5 ГБ | Apache 2.0 | |
| | ae (VAE) | 0.3 ГБ | Apache 2.0 | |
| | face_yolov8m + SAM | 0.4 ГБ | — | |
| |
| Скрипт сверяет размер каждого скачанного файла с эталоном. Битый файл будет пойман сразу, а не через час непонятных ошибок. |
| |
| --- |
| |
| ## Безопасность |
| |
| - Токен вписывай **свой**. Переменные окружения видны изнутри пода любому, у кого есть к нему доступ. |
| - Используй **Read**-токен, не Write. Read не даёт ничего испортить. |
| - Не вставляй токен в сам скрипт — только в переменную окружения. |
| |
