如何用 safe-mode 启动 InsightFace GUI 排查模型加载失败【免费下载链接】insightfaceState-of-the-art 2D and 3D Face Analysis Project项目地址: https://gitcode.com/GitHub_Trending/in/insightfaceInsightFace Evaluation StudioInsightFace 1.0.1 的本地桌面 GUI启动时会自动加载模型一旦模型缺失、provider 配置有问题启动过程就卡在这次自动加载上日志和报错混在一起。--safe-mode启动参数可以让 GUI 直接跳过自动加载模型这一步先确认程序本身能打开、界面能操作再单独处理模型问题。这个参数只对当前这次启动生效不会写进config.json排查完成后正常启动即可恢复自动加载。本文适用环境已通过 GUI extra 安装 InsightFace 的机器入口命令为insightface-gui或别名insightface-eval-studio、insightface-desktop、python -m insightface.gui。先确认失败发生在模型加载环节正常启动后GUI 会在 250ms 后触发自动加载。加载完成时状态栏会显示Model loaded.如果加载出错状态栏会显示引擎记录的错误信息engine.last_error见 main_window.py。排查前先做两件事避免把无关问题误判成模型问题insightface-gui --version文档测试用例中该命令的预期输出文档示例为InsightFace Evaluation Studio 1.0.1 insightface 1.0.1如果连PySide6都缺失程序会直接打印InsightFace GUI requires PySide6.并提示pip install insightface[gui]这属于安装问题而不是模型加载失败见main.py。用 safe-mode 跳过模型加载启动 GUIinsightface-gui --safe-mode--safe-mode在命令行中的定义是Open the GUI without loading a model见main.py。它的行为边界由文档和代码共同确认只作用于当前这次启动不会保存到config.jsongui.md 的 Troubleshooting 一节。跳过逻辑在 main_window.py只有当auto_load_model为真且本次不是 safe-mode 运行时才会调度自动加载。即使旧的构建版本曾把safe_mode持久化进过config.json启动逻辑也会强制把它重置为False并恢复auto_load_model True防止之后的正常启动静默跳过模型加载app.py。这一点由测试test_safe_mode_is_runtime_only覆盖它断言runtime_safe_mode is True而config.safe_mode is False、auto_load_model is Truetest_cli.py。safe-mode 下界面能打开的判据各功能页面Face Recognition、Album、Batch、Face Swap 等在未加载模型时会显示提示文案Model is not loaded. Please open Models.文档明确说明 GUI 在模型缺失时依然会打开gui.md所以“窗口打开 页面显示该提示”就是 safe-mode 按预期工作的表现而不是报错。safe-mode 下逐个排除模型问题启动后按下面两条路径处理它们对应文档 Troubleshooting 一节给出的两个方向gui.md1. 怀疑是 provider 问题强制 CPUinsightface-gui --provider cpu文档说明CUDA只有在 ONNX Runtime 报告存在CUDAExecutionProvider时才可被选中在一台没有可用 CUDA provider 的机器上请求 CUDA 时GUI 会回退到 Auto/CPU而不是暴露一个坏掉的 GPU 选项。启动逻辑里对配置中的CUDA也做同样回退app.py。如果强制 CPU 后模型能正常加载说明问题出在 GPU/provider 链路上。2. 怀疑是模型文件缺失检查本地模型目录GUI 不会自动下载模型。文档给出的两条获取途径打开Models Downloads点击Refresh Download URLs拉取最新 release assets下载包解压到~/.insightface/models/model_name/例如~/.insightface/models/buffalo_l/、~/.insightface/models/antelopev2/或手动把模型目录放到~/.insightface/models/下再在Models Runtime选择custom model directory指向自己的目录。模型包可选buffalo_l、buffalo_s、antelopev2或自定义模型目录provider 可选 Auto、CPU以及可用时的 CUDAgui.md。验证修复结果修复动作做完后用不带参数的正常启动来验证而不是继续用 safe-modeinsightface-gui成功的可观察结果是状态栏出现Model loaded.main_window.py并且各页面不再显示Model is not loaded. Please open Models.提示而是能执行识别、批量处理等任务。如果仍然失败文档指明的下一步是查看日志文件~/.insightface/gui/logs/app.log工作区位于~/.insightface/gui含 SQLite 数据库、crops、导出、报告与日志用insightface-gui --workspace /path/to/workspace可以指定其他工作区目录gui.md。限制说明--safe-mode是诊断参数不会修复模型问题本身关掉窗口后下次正常启动仍会执行自动加载如果根因没解决会再次失败。该参数只影响“是否自动加载模型”不影响 workspace、数据库或已保存的数据文档也未描述它清除缓存或重置配置的行为。文档列出的命令行参数为--workspace、--model、--provider、--safe-mode、--versionmain.py其中--model可接收模型包名或本地模型目录可在无法通过界面操作时配合使用。【免费下载链接】insightfaceState-of-the-art 2D and 3D Face Analysis Project项目地址: https://gitcode.com/GitHub_Trending/in/insightface创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
如何用 safe-mode 启动 InsightFace GUI 排查模型加载失败【免费下载链接】insightfaceState-of-the-art 2D and 3D Face Analysis Project项目地址: https://gitcode.com/GitHub_Trending/in/insightfaceInsightFace Evaluation StudioInsightFace 1.0.1 的本地桌面 GUI启动时会自动加载模型一旦模型缺失、provider 配置有问题启动过程就卡在这次自动加载上日志和报错混在一起。--safe-mode启动参数可以让 GUI 直接跳过自动加载模型这一步先确认程序本身能打开、界面能操作再单独处理模型问题。这个参数只对当前这次启动生效不会写进config.json排查完成后正常启动即可恢复自动加载。本文适用环境已通过 GUI extra 安装 InsightFace 的机器入口命令为insightface-gui或别名insightface-eval-studio、insightface-desktop、python -m insightface.gui。先确认失败发生在模型加载环节正常启动后GUI 会在 250ms 后触发自动加载。加载完成时状态栏会显示Model loaded.如果加载出错状态栏会显示引擎记录的错误信息engine.last_error见 main_window.py。排查前先做两件事避免把无关问题误判成模型问题insightface-gui --version文档测试用例中该命令的预期输出文档示例为InsightFace Evaluation Studio 1.0.1 insightface 1.0.1如果连PySide6都缺失程序会直接打印InsightFace GUI requires PySide6.并提示pip install insightface[gui]这属于安装问题而不是模型加载失败见main.py。用 safe-mode 跳过模型加载启动 GUIinsightface-gui --safe-mode--safe-mode在命令行中的定义是Open the GUI without loading a model见main.py。它的行为边界由文档和代码共同确认只作用于当前这次启动不会保存到config.jsongui.md 的 Troubleshooting 一节。跳过逻辑在 main_window.py只有当auto_load_model为真且本次不是 safe-mode 运行时才会调度自动加载。即使旧的构建版本曾把safe_mode持久化进过config.json启动逻辑也会强制把它重置为False并恢复auto_load_model True防止之后的正常启动静默跳过模型加载app.py。这一点由测试test_safe_mode_is_runtime_only覆盖它断言runtime_safe_mode is True而config.safe_mode is False、auto_load_model is Truetest_cli.py。safe-mode 下界面能打开的判据各功能页面Face Recognition、Album、Batch、Face Swap 等在未加载模型时会显示提示文案Model is not loaded. Please open Models.文档明确说明 GUI 在模型缺失时依然会打开gui.md所以“窗口打开 页面显示该提示”就是 safe-mode 按预期工作的表现而不是报错。safe-mode 下逐个排除模型问题启动后按下面两条路径处理它们对应文档 Troubleshooting 一节给出的两个方向gui.md1. 怀疑是 provider 问题强制 CPUinsightface-gui --provider cpu文档说明CUDA只有在 ONNX Runtime 报告存在CUDAExecutionProvider时才可被选中在一台没有可用 CUDA provider 的机器上请求 CUDA 时GUI 会回退到 Auto/CPU而不是暴露一个坏掉的 GPU 选项。启动逻辑里对配置中的CUDA也做同样回退app.py。如果强制 CPU 后模型能正常加载说明问题出在 GPU/provider 链路上。2. 怀疑是模型文件缺失检查本地模型目录GUI 不会自动下载模型。文档给出的两条获取途径打开Models Downloads点击Refresh Download URLs拉取最新 release assets下载包解压到~/.insightface/models/model_name/例如~/.insightface/models/buffalo_l/、~/.insightface/models/antelopev2/或手动把模型目录放到~/.insightface/models/下再在Models Runtime选择custom model directory指向自己的目录。模型包可选buffalo_l、buffalo_s、antelopev2或自定义模型目录provider 可选 Auto、CPU以及可用时的 CUDAgui.md。验证修复结果修复动作做完后用不带参数的正常启动来验证而不是继续用 safe-modeinsightface-gui成功的可观察结果是状态栏出现Model loaded.main_window.py并且各页面不再显示Model is not loaded. Please open Models.提示而是能执行识别、批量处理等任务。如果仍然失败文档指明的下一步是查看日志文件~/.insightface/gui/logs/app.log工作区位于~/.insightface/gui含 SQLite 数据库、crops、导出、报告与日志用insightface-gui --workspace /path/to/workspace可以指定其他工作区目录gui.md。限制说明--safe-mode是诊断参数不会修复模型问题本身关掉窗口后下次正常启动仍会执行自动加载如果根因没解决会再次失败。该参数只影响“是否自动加载模型”不影响 workspace、数据库或已保存的数据文档也未描述它清除缓存或重置配置的行为。文档列出的命令行参数为--workspace、--model、--provider、--safe-mode、--versionmain.py其中--model可接收模型包名或本地模型目录可在无法通过界面操作时配合使用。【免费下载链接】insightfaceState-of-the-art 2D and 3D Face Analysis Project项目地址: https://gitcode.com/GitHub_Trending/in/insightface创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
)
