企业官网建设流程全解析

Deep-Live-Cam 部署踩坑实录：3 个模型报错一次清零，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

Deep-Live-Cam 支持单张图片驱动的实时换脸，本文专治启动时的模型缺失报错。刚 clone 下来就跑，终端直接吐红色报错，基本都卡在同一处：两个 ONNX 模型文件没放对位置。按「建目录、下模型、跑验证」三件事做完，你就能打开界面、选张图完成第一次换脸。

H2-A｜报错现场

DLC.FACE-SWAPPER: Model not found in /path/to/Deep-Live-Cam/models. Please download inswapper_128.onnx. DLC.FACE-ENHANCER: GFPGAN ONNX model not found at /path/to/Deep-Live-Cam/models/gfpgan-1024.onnx. Frame processor face_swapper not found

共性根因很直接：程序只在项目根目录的models文件夹里找模型文件，缺哪个就报哪个，文件齐了报错自然消失。

H2-B｜它到底在找什么

程序对 inswapper 有兜底：只给 fp32 版inswapper_128.onnx也能加载；增强模块则只认gfpgan-1024.onnx，名字一个字符都不能差。

H2-C｜动手：三件事跑通

把 models 目录建对

• 在项目根目录新建models，文件夹名必须小写。
• 它要和run.py同级，这是最容易错的一步。
• 项目本身不自带 models 文件夹，需要你自己创建。

Deep-Live-Cam/ ├── models/ ← 必须小写，程序只认这里 │ ├── inswapper_128_fp16.onnx │ └── gfpgan-1024.onnx ├── modules/ └── run.py

把两个模型文件放进去

• 到项目 README 指向的官方模型仓库页下载，两个文件都要拿。
• 文件名保持原始命名，不加空格、不改后缀。
• 放好后用ls -lh models（Windows 用dir）核对大小是否对上，防下载不完整。

跑一次验证

• 确认 venv 已激活，依赖装完，再执行启动命令。
• 界面正常弹出，且状态栏提示模型加载成功，就算跑通。
• 界面里选源脸图和一张目标图，点 Start，输出会存到以目标文件命名的目录。

python run.py

H2-D｜验证 & 排错

验证方式就一条命令：python run.py。看到界面正常打开、状态栏出现model loaded successfully字样，即配置成功。

H2-E｜性能参考

H2-F｜最后

• 目录位置：models与run.py同级，文件夹名必须小写。
• 文件名：inswapper_128_fp16.onnx、gfpgan-1024.onnx，保持原始命名。
• 验证方式：python run.py，界面弹出且模型加载成功即完成。

跑通之后，剩下的就是玩起来了。

【免费下载链接】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