5分钟跑通 Deep-Live-Cam 实时换脸：从“Model not found“报错到 Live 预览

5分钟跑通 Deep-Live-Cam 实时换脸从Model not found报错到 Live 预览【免费下载链接】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敲下python run.py状态栏却提示 Model not found in models/Live 按钮点不动——这是 Deep-Live-Cam 卡住新手最多的地方。这篇文章按你的显卡选型、讲清 2 个模型文件的放置位置、给出最少安装动作让你 5 分钟内看到 Live 窗口里的实时换脸效果。 先看显卡再定方案Deep-Live-Cam 执行器怎么选别急着装依赖先看一个指标你电脑里是什么显卡。它直接决定你该用哪个--execution-provider和哪个模型文件。第二个判断依据是系统macOS 的 Apple 芯片必须走 CoreMLWindows 集显只能走 CPU。三条主流路径对应帧率是典型机型的实测范围路径启动方式换脸模型典型帧率CPU无独显python run.py默认inswapper_128.onnxFP32约 554 MB5-10 fpsNVIDIA 独显python run.py --execution-provider cudainswapper_128_fp16.onnxFP16约 278 MB30-40 fpsApple 芯片 Macpython3.14 run.py --execution-provider coremlinswapper_128_fp16.onnxFP1625-35 fps如果你的显卡是 AMD 集显/独显Windows程序也能用 DirectML 跑帧率一般在 15-25 fps 之间但不确定时先用 CPU 路径把流程跑通再换加速器不迟。⚡ 最少 3 个动作Deep-Live-Cam 环境怎么装动作一拿到代码并建虚拟环境git clone --depth 1 https://gitcode.com/GitHub_Trending/de/Deep-Live-Cam cd Deep-Live-Cam python -m venv venv激活环境Windows 用venv\Scripts\activatemacOS/Linux 用source venv/bin/activate。完成标志python --version输出在 3.11-3.14 之间README 推荐 3.14。如果你的 Mac 还没有这个版本先执行brew install python3.14 brew install python-tk3.14。动作二安装依赖pip install -r requirements.txt完成标志安装结束没有红色报错终端最后一行回到命令提示符。这一步会自动装好 onnxruntime它决定了 Live 窗口能打开。动作三让 models/ 目录里有 2 个文件换脸需要两个模型程序会首次运行时自动下载所以这一步你可以只负责确认inswapper_128_fp16.onnx约 278 MB或inswapper_128.onnxFP32约 554 MB——换脸本体gfpgan-1024.onnx约 366 MB——面部增强网络差时会自动下载会很慢这时手动从模型仓库下载这两个文件放进项目的models/文件夹即可文件名一个字符都不能改说明见 models/instructions.txt。完成标志ls models/能看到上述文件启动后控制台打印GFPGAN ONNX model loaded successfully说明换脸链路加载成功。启动并验证python run.py完成标志GUI 界面出现后选一张人脸照片 → 选摄像头 → 点 Live10-30 秒后预览窗出现换脸画面。到这一步最小闭环就跑通了。 常见报错自助速查Deep-Live-Cam 排障表报错 / 现象可能原因最简解法Model not found in models/模型文件不在models/目录放入inswapper_128_fp16.onnx或联网后重启让程序自动下载ModuleNotFoundError: No module named _tkintermacOS没装 GUI 依赖brew install python-tk3.14然后用python3.14启动CUDA provider 初始化失败缺 CUDA/cuDNN 或版本不匹配装 CUDA Toolkit 12.8 cuDNN 8.9.7再pip install onnxruntime-gpu1.26.0急用就切--execution-provider cpuLive 画面卡顿、掉帧模型精度或摄像头分辨率偏高先关面部增强试一次仍卡就降摄像头分辨率装依赖后命令仍报错依赖残留冲突删掉venv目录重来重建虚拟环境后重新pip install -r requirements.txt排障细节可对照源码中模型加载与下载逻辑modules/processors/frame/face_swapper.py。 进阶能跑通之后再动的 3 个开关展开口型遮罩 / 多人换脸 / 稳定性取舍口型遮罩Mouth Mask保留你本人的嘴部动作替换后的脸会跟着原视频说话适合直播口播场景效果最自然。多人换脸Many Faces Face Mapping同时给画面里多个人换脸还能指定谁换谁群像视频一步到位。FP32 模型换 FP16如果 GPU 上偶尔出花屏或画面异常把inswapper_128.onnxFP32约 554 MB放进models/用老一点的显卡反而更稳。✅ 完成标志自检你成功了吗逐条对照全部打勾就是跑通了ls models/里有 inswapper 换脸模型 gfpgan 增强模型python run.py能打开 GUI控制台无红色报错点 Live 后 10-30 秒内出现换脸预览帧率稳定在你的目标值GPU 用户控制台显示对应执行器已生效而非回落到 CPU最典型的用法是用 OBS 把 Live 窗口作为采集源推流或录制你的摄像头在对方眼里就已经是另一张脸。现在按上面的动作走一遍——装好依赖、放好模型、点下 Live剩下的交给程序。【免费下载链接】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），仅供参考