TypeError: init() got an unexpected keyword argument ‘simple_vram_headroom’
快速结论：该报错通常出现在 ComfyUI EZi Desktop 启动时，原因是内置的 comfy-aimdo 包版本过低，与当前 ComfyUI 核心代码不兼容。优先通过终端升级 comfy-aimdo 到 0.4.10 版本。
问题场景
用户在运行 ComfyUI EZi Desktop v3.7.3 时触发。打开应用后程序停止运行，控制台输出 TypeError: init() got an unexpected keyword argument 'simple_vram_headroom'。
报错原文
TypeError: init() got an unexpected keyword argument 'simple_vram_headroom'原因分析
ComfyUI 核心的 simple_vram_headroom 参数在较新版本的 ComfyUI 代码中已被修改或移除，但内置的 comfy-aimdo 包（或相关依赖）仍按旧接口传递该参数，导致初始化失败。属于依赖版本不匹配问题。
注意：Issue 中并未给出完整的调用栈或确认哪个具体模块传递了该参数，因此 simple_vram_headroom 的来源也可能是其他自定义节点或缓存冲突，但升级 comfy-aimdo 是已确认的解决方法。
环境排查
- 确认 ComfyUI EZi Desktop 版本是否为 v3.7.3。
- 检查
python_embeded目录下comfy-aimdo的当前版本：在终端中运行.\python.exe -m pip show comfy-aimdo。 - 确认 Python 版本和 pip 版本是否正常。
解决步骤
- 进入 ComfyUI EZi Desktop 安装目录下的
python_embeded文件夹（例如C:\Program Files\ComfyUI-Desktop\python_embeded）。 - 在该目录下打开终端（PowerShell 或 CMD）。
- 执行以下命令安装指定版本的
comfy-aimdo：
.\python.exe -m pip install comfy-aimdo==0.4.10 - 等待安装完成后，重新启动 ComfyUI EZi Desktop。
如果升级后问题仍然存在，可尝试完全卸载 comfy-aimdo 并重新安装：
.\python.exe -m pip uninstall comfy-aimdo -y
.\python.exe -m pip install comfy-aimdo==0.4.10
验证方法
重新打开 ComfyUI EZi Desktop，程序应正常加载，不再出现该 TypeError。可以正常运行工作流以确认无其他报错。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口？
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。
推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。
