comfy-character-app：基于 ComfyUI 的角色图像生成工具

comfy-character-app 是一个专为 ComfyUI 构建的 Gradio 前端应用，旨在帮助用户更高效地生成具有高度一致性与细节控制的角色图像。该项目由开发者 Praecordi 创建，结合了 ComfyScript 技术，实现了介于 Python 脚本与 ComfyUI API 之间的灵活工作流程。

• GitHub：https://github.com/Praecordi/comfy-character-app

示例角色输出流程：基础图像 → 潜在空间上采样 → 修复步骤（面部、皮肤、头发、眼睛） → 图像上采样 → 移除背景

它特别适合用于：

• 角色数据集生成
• 多步骤细节增强（面部、皮肤、头发、眼睛）
• 风格迁移与图像修复
• 快速构建和迭代角色形象库

 核心功能

技术架构概览

该项目建立在以下核心组件之上：

• ComfyUI：提供底层节点式图像生成能力
• ComfyScript：用于编写模块化的生成逻辑，介于脚本与图形界面之间
• Gradio：实现交互式前端界面，方便非编程用户操作
• Florence2：用于图像描述生成，辅助提示词构建
• Custom Nodes：集成多个高质量插件以扩展功能（见“依赖”部分）

 依赖与安装要求

✅ 系统要求

• Python 3.8 或以上版本
• 已安装并运行 ComfyUI
• Gradio 和相关依赖库
• ComfyScript（GitHub 地址）

📦 所需 ComfyUI 自定义节点

确保你已安装以下节点插件：

• ComfyUI Impact Pack
• ComfyUI Impact Subpack
• ComfyUI Inspire Pack
• ComfyUI InstantID
• ComfyUI Essentials
• ComfyUI Segment Anything
• Comfyroll Studio
• ComfyUI Neural Network Latent Upscale
• ComfyUI ReActor
• ComfyUI Detail Daemon
• ComfyUI Florence2

🛠 安装步骤

1. 激活 ComfyUI 虚拟环境

source .venv/bin/activate # Linux/macOS
.venv\Scripts\activate # Windows

2. 克隆项目仓库

cd path/to/where/you/want/to/install
git clone https://github.com/Praecordi/comfy-character-app.git
cd comfy-character-app/

⚠️ 注意：无需将此目录放入 ComfyUI 的 custom_nodes 文件夹中。

3. 安装依赖项

pip install -r requirements.txt

4. 配置文件设置

复制模板并编辑 config.json：

cp config.example.json 
config.json

示例配置如下：

{
"comfyui_installation": "/path/to/your/comfyui",
"comfyui_server_url": "http://127.0.0.1:8188",
"characters_config": "./characters.json",
"app_constants": {
"union_controlnet": "your_controlnet.safetensors",
"instantid_model": "your_instantid.bin",
"instantid_controlnet": "your_instantid_controlnet.safetensors",
"lcm_lora": "your_lcm_lora.safetensors",
"turbo_lora": "your_turbo_lora.safetensors",
"dpo_turbo_lora": "your_dpo_turbo_lora.safetensors"
}
}

5. 创建角色配置文件

参考 character.example.json 创建自己的角色定义文件，包含以下字段：

• main_subject：角色类型（如“战士”、“女巫”）
• face_prompt：面部特征描述
• skin_prompt：皮肤描述
• hair_prompt：发型描述
• eyes_prompt：眼睛特征
• face_reference：可选的面部参考图像路径

▶ 使用方式

启动应用只需一行命令：

python main.py

随后，打开浏览器访问 Gradio 提供的本地地址即可开始操作。

🔄 工作流程说明（可开关）

当前默认生成流程包括以下步骤：

1. 基础生成：生成初始角色图像
2. 潜在空间上采样：逐步放大潜在表示
3. 面部增强：精细调整面部特征
4. 皮肤增强：优化肤色与纹理
5. 头发增强：强化发丝细节
6. 眼睛增强：突出眼部表现
7. 图像上采样：最终图像高清输出
8. 背景移除：可选，用于提取主体

每一步均可通过 UI 控制是否启用。

⚠ 注意事项

• 当前仅支持 SDXL 架构模型
• SDXL 检查点应放在 models/sdxl/ 目录下，Pony 模型放在 pony/
• Lightning、Hyper、Turbo 模型通过名称自动识别（如包含 “Lightning”、“Hyper4S”、“Hyper8S”、“Turbo”）

🧑‍💻 角色管理器

角色管理器是一个内置的 UI 模块，允许你在不手动编辑 JSON 文件的情况下：

• 查看并切换角色
• 编辑提示词与属性
• 分配或预览参考图像
• 保存更改到配置文件

所有更改都会实时反映在当前会话中，并持久化保存至 characters.json，非常适合批量生成和调试。

🚀 总结

comfy-character-app 是一个专为角色图像生成设计的 Gradio 应用，结合 ComfyUI 与 ComfyScript，提供了强大的多阶段生成与编辑能力。无论你是想快速生成角色原型、构建角色数据库，还是探索复杂的人物设定，这款工具都能为你带来更高的效率与灵活性。