IOPaint 免费 AI 消除工具实操教程：不用显卡，十分钟抹掉照片里的水印和杂物-迪斯科星球

IOPaint 免费 AI 消除工具实操教程：不用显卡，十分钟抹掉照片里的水印和杂物

【免费下载链接】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 是一款开源免费的 AI 消除工具，能把照片里的物体、路人、水印无缝抹掉，还支持消除后替换内容。会复制粘贴命令就能跑，全程不需要显卡。最容易被绊住的点是 Python 版本和首次模型下载，总耗时约 10 到 15 分钟。

先看结果

装好之后，IOPaint 会在本机开一个网页，你上传照片、用画笔圈掉不想要的区域，一次点击就能修好。下面是项目官方演示的消除前后对比：

上图水印盖了整张照片，下图是擦除后的效果：背景纹理被自动补齐，放大看也几乎找不到修补痕迹。

开始之前要备齐什么

装之前花一分钟把三件事过一遍，能省掉后面大半的排错时间：

Python 版本：终端里敲python -V看一眼。项目支持的版本上限是 3.10，选 3.10.x 最省事。显示 3.8 或 3.11 的话，先装一个 3.10，安装器里"把 Python 加入 PATH"那个勾别漏，否则后面每条命令都得敲完整路径。
网络：装依赖走 pypi，模型要从 HuggingFace 拉，国内网络慢的话先换镜像源（下一条就讲）。
端口与磁盘：8080 是默认启动端口，被占用的话后面改 8081 就行；依赖里带 PyTorch，安装体积不小，磁盘留足 10GB 比较稳。

动手安装

🎯 下面所有操作都在同一个终端窗口里做，环境才能一直连着。

第一步，建虚拟环境。它相当于给项目单独配的一个柜子：柜子里装的包只服务 IOPaint，不会弄乱系统里的 Python。

python -m venv venv

当前目录多出一个 venv 文件夹、没有任何报错，这步就成了。

第二步，激活它。

# Windows venv\Scripts\activate # macOS / Linux source venv/bin/activate

成功标志：命令行最前面出现(venv)前缀。

第三步（可选），换国内镜像源。PyTorch 一个包就是好几个 GB，走官方源在国内经常半天没动静，提前换掉更省心。

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

命令正常返回、无报错，就设置生效了，以后装包都会走镜像。

第四步，安装本体。

pip install -U iopaint

终端刷出大量下载日志是正常现象，耐心等它跑完。成功标志：末尾出现Successfully installed。装了多少包想核对的话，完整清单在 requirements.txt。

第一个实战任务

现在做一次真正的擦除。先用 CPU 加载轻量修复模型 lama 并启动服务：

iopaint start --model=lama --device=cpu --port=8080

⚠️ 第一次运行会在后台自动把模型下载到本机缓存（~/.cache目录），终端会滚动进度条，这段时间别关窗口；进度条走完，服务才算就绪。如果报错提示端口被占用，把--port改成 8081 重启即可。

浏览器打开 http://localhost:8080 就是编辑页。可以直接拿项目里的演示素材 assets/unwant_object.jpg（木梁屋顶挂着纸灯笼那张）练手：

上传图片；
用画笔把想删掉的灯笼刷一下，刷完可以在页面上微调遮罩边缘；
点消除，等几秒，新图出现，从页面下载即可。

顶上那几个灯笼消失后，屋顶的木梁和桁架衔接自然，没有涂抹感。

参数不用背，记住这三个就够：--model=lama（轻量擦除，默认推荐，CPU 就能跑）、--device=cpu（有 N 卡且装过 CUDA 版 PyTorch 才改 cuda）、--port=8080（被占用换 8081）。

卡住了？看这里

现象	原因	处理办法
命令说找不到`iopaint`	虚拟环境没激活，或 Python 不在 PATH	重做第二步激活，确认行首有`(venv)`
`pip install`长时间无响应或超时	连官方源太慢	做第三步换镜像源，重新执行安装
浏览器打不开 localhost:8080	模型还在下载中	等终端进度条走完，服务自然就绪
提示端口已被占用	8080 被别的程序占着	把`--port`改成 8081 重启
装依赖连环报错	`python -V`是 3.8 或 3.11	先装 3.10（记得勾 PATH），再重做以上步骤

✅ 走到这里能打开网页、成功擦出一张图，整个流程就算跑通了。

还能往哪走

擦除跑顺之后，可以接着玩两件事：

消除并替换：换成 PowerPaint 这类扩散模型，能把物体换成别的、或把画面外扩补全，各模型的实现代码都在 iopaint/model/，想深入看可以直接翻。
批量处理：一文件夹图片不用一张张点，命令行直接批处理：

iopaint run --model=lama --device=cpu \ --image=input_folder \ --mask=mask_folder \ --output=output_dir

input_folder放原图，mask_folder放与原图同名的遮罩图（黑底白区是要消除的位置），结果统一落在output_dir。背景移除、交互式分割等插件在 iopaint/plugins/，启动命令加对应的--enable-开关就能打开。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析