4 步跑通 Deep-Live-Cam 实时换脸：从模型下载到第一帧出图-港品优选

4 步跑通 Deep-Live-Cam 实时换脸：从模型下载到第一帧出图

【免费下载链接】Deep-Live-Camreal time face swap and one-click video deepfake with only a single image项目地址: https://gitcode.com/GitHub_Trending/de/Deep-Live-Cam

终端刷出一屏 CUDA 报错，models/里空空如也，光标还在闪。Deep-Live-Cam 只需一张照片就能做实时换脸，但模型加载这一步劝退了不少人。照下面走一遍：下模型、建环境、选对执行提供器，就能等来第一帧画面。

快速导航

没有独立显卡：直接看第 2、3 节，默认 CPU 模式就能跑
有 NVIDIA 显卡：重点看第 4 节 CUDA 执行提供器
启动就报错：先翻第 5 节排错表
已经能跑、嫌卡：跳第 6 节效果提升

📥 模型文件放哪里

程序启动时会检查模型是否就位，缺失就会卡住或反复提示。仓库里 models/ 文件夹中有一份 instructions.txt，核心就两个文件：

inswapper_128_fp16.onnx：换脸主力模型，约 380MB
GFPGANv1.4.onnx：面部增强模型，约 350MB

从 Hugging Face 的hacksider/deep-live-cam模型库下载后，直接丢进models/文件夹，文件名一个字符都不要改。

ls models/ # 能看到 inswapper_128_fp16.onnx 和 GFPGANv1.4.onnx # 就对了

到这里模型已经就位。如果某次下载中断，核对文件大小，重新下载即可。

Deep-Live-Cam 换脸效果演示

🧩 搭好 Python 环境再装依赖

依赖版本卡得比较死，用独立虚拟环境可以避免和系统 Python 打架。先拿到代码，再建环境、装依赖，一个块里做完。

git clone https://gitcode.com/GitHub_Trending/de/Deep-Live-Cam cd Deep-Live-Cam python -m venv venv source venv/bin/activate # Windows 用 venv\Scripts\activate # 省略… pip install -r requirements.txt

Python 版本 3.11–3.14 都支持，推荐 3.14；另外还需要系统里装好 ffmpeg，Windows 用户顺手装一下 Visual Studio 2022 运行库。

安装跑完，最后一行出现Successfully installed、提示符前多了(venv)前缀，环境就建好了。

🎛️ 选对执行提供器

CUDA 报错大多出现在这一步：执行提供器和你的硬件对不上。按硬件选对应参数启动：

你的硬件	启动命令
集显 / 无独显（默认）	`python run.py`
NVIDIA 显卡	`python run.py --execution-provider cuda`
Apple Silicon	`python run.py --execution-provider coreml`
AMD 显卡（Windows）	`python run.py --execution-provider directml`

NVIDIA 用户注意：先装好 CUDA Toolkit 12.8 和 cuDNN 8.9.7，再把推理引擎换成 GPU 版：

pip uninstall onnxruntime onnxruntime-gpu pip install onnxruntime-gpu==1.26.0 python run.py --execution-provider cuda

提供器逻辑写在 modules/core.py 的参数解析里，启动日志里出现CUDAExecutionProvider而不是只剩 CPU，说明 GPU 加速生效了。

普通 PC 上的性能面板演示

▶ 启动与验证

直接跑：

python run.py

弹出界面后：选一张正面清晰的源脸照片，选好摄像头，点 Live。首次启动要等 10–30 秒加载模型和初始化摄像头，预览画面出来后，第一帧换脸就算跑通了。想处理视频则选源照片加目标视频，点 Start，结果会存到以目标视频命名的文件夹里。

Live 模式下的多人换脸演示

🛠 排错速查表

症状	原因	修复
提示模型未找到	文件没放进`models/`或文件名不一致	核对文件名，重新放入`models/`
CUDAExecutionProvider 报错	CUDA/cuDNN 未装或显卡不支持	装 CUDA 12.8 + cuDNN 8.9.7，或改用`--execution-provider cpu`
Mac 提示缺`_tkinter`	系统没装 GUI 库	`brew install python-tk@3.14`
能跑但只有个位数 fps	CPU 模式 + 同时开了面部增强	先关增强功能，再试 GPU 执行提供器
模型加载中途失败	模型文件损坏或下载不完整	删除后重新下载，核对文件大小

效果提升

Live 预览掉帧 → 在界面上关掉 Face Enhancer，跳过第二次 ONNX 推理（开关状态见 modules/globals.py 的fp_ui）→ 帧率立竿见影，代价是皮肤细节略降。
嘴型对不上 → 启动加--mouth-mask，保留原始嘴部区域 → 口型动作跟得上。
画面里多人 → 启动加--many-faces，或配合 Face Mapping 指定哪张脸用哪个源照片 → 多人同框不再互相"抢脸"。

收尾

把一张正面照拖进源照片位置，点 Live，10 秒后第一帧出现，最难的坎就过去了。

【免费下载链接】Deep-Live-Camreal time face swap and one-click video deepfake with only a single image项目地址: https://gitcode.com/GitHub_Trending/de/Deep-Live-Cam

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析