IOPaint AI修图工具完整指南从安装避坑到进阶实战4条命令跑通【免费下载链接】IOPaintImage inpainting tool powered by SOTA AI Model. Remove any unwanted object, defect, people from your pictures or erase and replace(powered by stable diffusion) any thing on your pictures.项目地址: https://gitcode.com/GitHub_Trending/io/IOPaint输入iopaint start却弹出 CUDA is not available或模型下载卡住不动或页面能打开但修出来的图全黑——这是新手用 IOPaint 这款 AI 图像修复工具最易踩的 3 个坑。本文带你从依赖安装到服务跑通并讲清每步背后的原理。首次启动翻车排查清单3 个高频坑与成因新手卡住90% 集中在下面三处。先对号入座再走修复流程。症状成因判断方法启动报CUDNN_STATUS_NOT_INITIALIZED或 CUDA is not availableIOPaint 锁定 PyTorch 2.1.2 cu118 这套特定构建而 pip 默认装的 torch 是更新的 CUDA 版本两者对不上python -c import torch;print(torch.__version__)看是否 2.1.2服务启动后长时间卡住最终网络超时模型在首次启动时才从模型源拉取网络不稳就会中断iopaint list能列出模型才算真正落盘SD 类大模型崩溃或输出整片黑/绿显存/内存不足或半精度在该卡上不稳定加--low-mem --cpu-offload仍黑/绿则加--no-half正常修图效果长这样左原图含多余物体右IOPaint 抹除后图注含多余物体的原图修复目标就是让这块区域被自然背景补齐。图注同一场景经 IOPaint 抹除后原物体位置被合理补全边缘无明显痕迹。一步步打通正确安装顺序与 3 步修复解法一先装对 PyTorch再装 IOPaint先做按 IOPaint 锁定的版本装 PyTorch再装主包见 README.md 的 Quick Start。pip3 install torch2.1.2 torchvision0.16.2 --index-url https://download.pytorch.org/whl/cu118 pip3 install iopaint为什么有效iopaint的依赖解析在 torch 之后进行先装好版本固定的 torch能挡住 pip 自动拉一个不匹配的默认 torch。好比先定好钢筋型号再浇混凝土——先装 iopaintpip 会替你挑默认钢筋很可能不合模。⚠️ 装完先自检版本python -c import torch;print(torch.__version__)显示 2.1.2 才继续若显示别的版本先pip uninstall torch再重装。解法二预下载模型用 list 验证落盘先做把默认擦除模型提前拉下来并确认它真的在本地。iopaint download --modellama iopaint list为什么有效把下载从启动时刻拆出来网络问题就不再和代码问题混在一起list直接读模型目录能列出文件才算就绪。类比开火前先清点 pantry 库存避免做到一半才发现缺料。⚠️ 若下载超时可给命令加--model-dir指向一个你方便管理/加速的目录换网络再试不要反复重启服务。解法三用最轻配置先跑通再加省内存开关先做用最小的擦除模型 CPU 把服务拉起来。iopaint start --modellama --devicecpu --port8080为什么有效lama 是体量和内存需求都最低的擦除模型CPU 就能跑适合验证整条链路通不通。等它跑通再按需切 GPU 或更大的扩散模型并叠加--low-mem --cpu-offload把权重卸到内存、开启切片以省显存。类比汽车点火先空挡确认发动机没问题再谈换挡提速。效果自查5 个指标确认真的跑通不靠感觉用下面清单逐项打钩预期效果 自查方法✅页面可达浏览器打开http://localhost:8080能看到编辑界面说明后端已起。✅模型落盘iopaint list输出里出现lama说明下载成功。✅版本对版启动日志会打印环境信息表核对其中 torch 一行是否为 2.1.2。✅修复有效对一张图做 inpaintmask 区域被自然补全、边缘无明显接缝对照上文前后图。✅内存可控CPU lama 时内存占用平稳换扩散模型时盯任务管理器/活动监视器涨得过高就加--low-mem --cpu-offload。黑/绿图若输出整片黑或绿是半精度问题加--no-half用全精度重跑即可。再进一步批量修复与一键蒙版插件批量修复把整文件夹的图和对应蒙版一次处理完单张蒙版还能复用到多张图上适合成批清理。iopaint run --modellama --devicecpu --image./photos --mask./masks --output./out额外价值省去逐张点选几十张图一次跑完蒙版可目录对应也可指定为单个文件套用到全部图参数定义见 iopaint/cli.py。交互分割插件不想手刷蒙版时点一下自动圈出目标物体。iopaint start --enable-interactive-seg --interactive-seg-devicecuda额外价值把画蒙版这个最费时的步骤自动化。下方这张就是典型去水印场景——原图多处水印修复后底图干净、无残影图注水印清理后的照片证明 IOPaint 对叠加文字类瑕疵的擦除能力。快速启动4 条命令跑通 IOPaint按顺序执行CPU 用户可跳过第一条 GPU 版 torch直接用 pip 默认 torchpip3 install torch2.1.2 torchvision0.16.2 --index-url https://download.pytorch.org/whl/cu118 pip3 install iopaint iopaint download --modellama iopaint start --modellama --devicecpu --port8080打开http://localhost:8080上传第一张图刷一下 mask按下修复——现在就去抹掉你相册里第一个不想要的物体吧。【免费下载链接】IOPaintImage inpainting tool powered by SOTA AI Model. Remove any unwanted object, defect, people from your pictures or erase and replace(powered by stable diffusion) any thing on your pictures.项目地址: https://gitcode.com/GitHub_Trending/io/IOPaint创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考