零基础玩转ComfyUI-LivePortrait：实时人像处理全流程配置指南

一、价值解析：为什么选择LivePortrait？ 🚀

ComfyUI-LivePortraitKJ是为ComfyUI打造的实时人像处理节点工具，让普通用户也能通过可视化编程实现专业级人像动画效果。无论是视频会议美颜、虚拟主播驱动还是创意内容制作，该工具都能提供低延迟、高保真的实时处理能力，无需深厚的AI开发背景。

二、准备工作：环境检查与依赖准备 📋

2.1 系统要求验证

• Python环境：需安装Python 3.x（推荐3.8+版本），通过python --version命令确认
• Git工具：用于获取项目源码，通过git --version检查是否安装
• ComfyUI基础：确保已完成ComfyUI主体程序安装（参考其官方文档）

[!TIP] Windows用户建议使用WSL2或PowerShell，避免命令行编码问题；Mac用户需确保Xcode Command Line Tools已安装。

2.2 核心依赖说明

依赖项	作用	选型理由
ComfyUI	可视化编程环境	提供节点式工作流，降低技术门槛
LivePortrait	人像动画引擎	支持实时视频流处理，性能优化出色
MediaPipe	人脸特征提取	Google开源方案，轻量高效适合实时场景
PyTorch	深度学习框架	提供模型推理支持，生态完善

三、实施步骤：四步完成安装配置 ⚙️

3.1 项目获取（前置检查）

git clone https://gitcode.com/gh_mirrors/co/ComfyUI-LivePortraitKJ
cd ComfyUI-LivePortraitKJ

[!TIP] 若克隆失败，检查网络连接或尝试使用SSH协议。国内用户可配置Git镜像加速。

3.2 依赖安装（核心安装）

# 基础依赖安装
pip install -r requirements.txt

# Mac用户特殊依赖
# pip install -r requirements-mac.txt

[!TIP] 推荐使用虚拟环境：python -m venv venv && source venv/bin/activate（Linux/Mac）或venv\Scripts\activate（Windows）

3.3 环境配置（环境适配）

1. 模型文件部署
   创建模型目录并放置LivePortrait模型文件：

   mkdir -p /path/to/ComfyUI/models/liveportrait
   # 将下载的模型文件放入上述目录
   

2. 环境变量设置
   添加模型路径环境变量（Linux/Mac）：

   echo 'export LIVEPORTRAIT_MODEL_PATH="/path/to/ComfyUI/models/liveportrait"' >> ~/.bashrc
   source ~/.bashrc
   

3.4 功能验证（功能验证）

1. 启动ComfyUI：在ComfyUI目录执行python main.py
2. 加载示例工作流：在浏览器界面导入examples/liveportrait_video_example_02.json
3. 运行测试：点击"Queue Prompt"执行，查看输出结果

四、项目结构解析 📁

项目采用模块化设计，核心目录功能如下：

ComfyUI-LivePortraitKJ/
├── assets/           # 示例素材（图片/视频）
├── face_alignment/   # 人脸对齐与检测模块
├── liveportrait/     # 核心算法实现
│   ├── config/       # 配置文件
│   ├── modules/      # 神经网络模块
│   └── utils/        # 工具函数
├── media_pipe/       # 人脸特征提取
└── examples/         # 工作流示例文件

图：LivePortrait处理效果示例图（原始素材）

五、常见问题解决 🔧

1. 依赖冲突：出现版本冲突时，尝试pip install --upgrade pip后重新安装
2. 模型缺失：确保模型文件完整，目录结构正确
3. 性能问题：降低视频分辨率或调整ComfyUI的推理精度设置
4. 节点不显示：检查ComfyUI的custom_nodes目录是否正确指向本项目

六、功能测试用例 ✅

测试项	操作步骤	预期结果
图片处理	加载source目录图片作为输入	生成带表情动画的输出图片
视频驱动	使用driving目录视频作为驱动	生成目标人像跟随驱动视频的动画
实时预览	连接摄像头输入	延迟<200ms的实时人像效果

通过以上步骤，您已完成ComfyUI-LivePortraitKJ的全部配置。现在可以开始探索实时人像动画的无限可能，从简单的表情迁移到复杂的姿态控制，尽情发挥创意！