IOPaint 避坑指南5分钟跑通AI修图3个报错一次讲清【免费下载链接】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/IOPaintIOPaint 是一款开源 AI 图像修复工具能一键擦掉照片里不想要的物体、水印和路人也支持用 Stable Diffusion 把某个元素替换成别的东西。本文带你从零装好它并把新手最常踩的几个坑提前绕过去。第一条命令5分钟出第一张修复图装 IOPaint 其实只需要两行命令。前提是电脑装好了 Python 3.9 及以上版本命令行输入python --version能出版本号就行。pip3 install iopaint iopaint start --modellama --devicecpu --port8080第一条把工具装进当前 Python 环境第二条启动本地服务默认加载 LaMa 模型一个擅长无痕擦除的轻量模型。终端里出现Uvicorn running on http://127.0.0.1:8080后用浏览器打开这个地址就能看到修图界面了。第一次启动会自动下载模型耐心等它走完进度条。 如果你只是日常擦除去水印、去路人LaMa 就够用体积小、CPU 也能跑只有把猫换成狗这类生成任务才需要上扩散模型。Windows 不想敲命令用官方一键脚本项目自带了打包好的 Windows 脚本位于 scripts/user_scripts/ 目录win_setup_cn.bat :: 首次安装自动配环境、装模型依赖 win_start_cn.bat :: 日常启动双击运行等脚本跑完、浏览器自动打开即成功。这套脚本内部帮你固定了 PyTorch 版本省去了很多手动排查的功夫。装不上按报错对号入座pip 下载 torch 极慢或失败国内网络下载 PyTorchAI 计算的深度学习框架相当于 IOPaint 的发动机很容易超时。解决办法是单独指定国内可访问的 PyTorch 官方索引源pip3 install torch2.1.2 torchvision0.16.2 \ --extra-index-url https://download.pytorch.org/whl/cu118IOPaint 要求的版本就是 2.1.2装完再执行pip3 install iopaint它检测到已有 torch 就不会重复下载。⚠️ 版本号必须对齐torch 2.1.2 对应 CUDA 11.8 的预编译包混用 2.2 或其他版本是后续各种玄学报错的根源。启动时报 CUDNN_STATUS_NOT_INITIALIZED这个报错 90% 是 PyTorch 的 CUDA 版本和你显卡驱动不匹配不是显卡坏了。按上面第一条装 cu118 版本的 torch然后重启终端再试。还有一个容易忽略的点--devicecuda启动后可以在 IOPaint 页面的设置里核对设备是否真的识别到了 GPU如果识别失败先别怀疑代码检查驱动管理器里显卡状态是否正常。浏览器打不开 8080 端口多半是端口被别的软件占了。换个端口即可iopaint start --modellama --devicecpu --port8081然后访问http://localhost:8081。端口号是任意的只要不冲突就行。显存不足、内存爆表加三个降级参数你的显存小于 6GB比如 4GB 的笔记本独显跑扩散模型时大概率会遇到 OOM内存溢出简单说就是显存被模型参数塞满了直接崩掉。IOPaint 内置了三个降级开关直接追加在启动命令里iopaint start --modelpowerpaint --devicecuda \ --low-mem --cpu-offload --no-half--low-mem降低推理时的内存峰值--cpu-offload把暂时不用的模型组件挪到内存给显存腾地方--no-half关闭半精度计算牺牲速度换稳定性三者可以只开一个也可以全开。速度会变慢但能保证不出错。另外模型默认下载位置空间不够时用--model-dir/你的目录换个盘存放。先想清楚你是要擦还是要画选错模型是新手卡住的另一个常见原因花 10 秒对一下你的需求用哪个模型特点去水印、去路人、去杂物lama快CPU 可跑把图中物体换成别的、扩图powerpaint生成质量高吃显存老照片划痕修复zits专为老照片设计模型参数就是--model后面的名字随时可以换不用重装。更多模型清单可以在 IOPaint 的界面里直接切换也可以看 批量处理模块 了解命令行模式的完整能力。批量处理老照片一条命令搞定照片多的时候不想一张张点用 IOPaint 的批处理模式iopaint run --modellama --devicecpu \ --image照片文件夹 --mask遮罩文件夹 \ --output输出文件夹--image是原图目录--mask里放与原图同名、同尺寸的遮罩白色区域要修复的区域结果自动存到--output。如果所有照片要用同一张遮罩--mask直接指向那个文件即可。现在就动手试试回到终端敲一下第一节的命令5 分钟后你就能在浏览器里擦掉第一张图里的路人。跑起来之后如果又蹦出报错先对照上面三个场景对号入座大概率能直接解决。【免费下载链接】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），仅供参考