cog-face-to-many

环境要求

• Python 3 环境（README 使用 python3 -m venv 创建虚拟环境）
• 具备 GPU 的机器（README 使用 Cog 容器运行，并暴露 8188 端口）
• 已安装 Cog（README 使用 sudo cog run 命令进入容器）
• ComfyUI 所需的 5 个自定义节点（Controlnet Aux、InstantID、IPAdapter Plus、Essentials、Efficien
• 基础模型 albedobaseXL_v13.safetensors，需放入 models/checkpoints

安装与启动步骤

1. 1克隆仓库含子模块

   使用 --recurse-submodules 一并拉取 ComfyUI 子模块，并进入 ComfyUI 目录。

   git clone --recurse-submodules https://github.com/fofr/cog-face-to-many.git && cd cog-face-to-many/ComfyUI

   复制

2. 2创建并激活虚拟环境

   在 ComfyUI 目录下创建 venv 并激活，隔离依赖。

   python3 -m venv . && source bin/activate

   复制

3. 3安装依赖

   按 requirements.txt 安装 ComfyUI 运行所需 Python 依赖。

   pip install -r requirements.txt

   复制

4. 4下载基础模型

   README 中该下载命令被截断，需将 albedobaseXL_v13.safetensors 自行下载并放入 models/checkpoints 目录。

5. 5安装自定义节点

   在 ComfyUI 中安装 Controlnet Aux、InstantID、IPAdapter Plus、Essentials、Efficiency Nodes 五个节点，链接见 README。

6. 6启动 Cog 容器

   在 GPU 机器上启动 Cog 容器并暴露 8188 端口，进入容器 shell。

   sudo cog run -p 8188 bash

   复制

7. 7容器内启动服务

   进入容器后启动 ComfyUI 服务，绑定 0.0.0.0 以便外部访问。

   cd ComfyUI/
   python main.py --listen 0.0.0.0

   复制

8. 8浏览器访问界面

   在本机浏览器用 GPU 机器 IP 和 8188 端口打开经典 ComfyUI 网页界面。

关键配置

如何确认成功

浏览器打开 http://<gpu-machines-ip>:8188，能看到经典 ComfyUI 网页表单界面即启动成功。

常见问题

注意事项

• README 中基础模型的下载命令被截断，需以仓库最新说明为准，不要照抄残缺链接。
• 本地开发必须带 --recurse-submodules，否则 ComfyUI 子模块缺失。
• ComfyUI 工作流文件为仓库根目录的 face-to-many-ui.json，可导入使用。
• 运行 Cog 容器需要 GPU 机器和 sudo 权限。