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 去水印与图像修复工具。你用画笔把水印区域圈出来，AI 自动把背景补全。它支持 CPU、GPU 和苹果芯片运行，适合想用可视化界面操作的人，也适合想用命令行一次处理整个文件夹的人。

先看效果：修复前后的对照

上面这张人像照片，右下角有一大块水印。走一遍修复流程后，人物边缘和背景纹理都补全了，看不出修补痕迹。

这张带文字水印的图片处理完后，文字连同底色一起消失，背景的明暗过渡保住了。两张图都是同一张图的修复前后对照，原始文件放在仓库的assets/目录里，可以自行比对。

最短路径：跑通第一张图

全部流程就三步，模型会在首次启动时自动下载，不用手动配置。

① 安装

pip3 install iopaint

装完终端里就有iopaint命令了，跑一下iopaint --help能看到全部可用指令。

② 启动服务

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

首次运行会先下载 LAMA 模型文件，下载完成后终端打印本地服务地址，浏览器就能访问了。

③ 打开 Web 界面

访问http://localhost:8080，上传一张照片，用画笔盖住水印，点开始修复。第一次下载模型稍慢，第二次启动就是秒开。下载位置不合适的话，加--model-dir指定目录，之后会一直复用。

有独立显卡的话，先装 CUDA 版 PyTorch，再把--device改成cuda，单张耗时能明显缩短。

按场景选模型：文字、老照片、漫画、批量

模型分两组：LAMA、ZITS、Manga 这类擦除模型负责去掉水印和物体；扩散模型负责替换物体、扩展画布。去水印场景从擦除模型里选就行。

照片文字水印选 LAMA

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

LAMA 速度快，对文字这种边界清晰的区域背景重建稳定，是日常去水印的默认选择。

老照片选 ZITS 加 GFPGAN

iopaint start --model=zits --enable-gfpgan --gfpgan-device=cpu

ZITS 擅长复杂纹理的修复，GFPGAN 专门做人脸恢复，一条命令同时把水印去掉、把人脸修清晰。

漫画选 Manga 专用模型

iopaint start --model=manga --device=cpu

Manga 模型针对漫画训练，修掉水印的同时不会破坏线稿和色块的边缘。

大批量文件用 iopaint run

iopaint run --model=lama --device=cpu \ --image=./input_images \ --mask=./mask_images \ --output=./results

--mask指向文件夹时，掩码图要和原图同名；指向单个文件时，所有图片共用这一张掩码。想加参数就看 README.md 里的完整说明。

参数速查：常用旗标一张表

参数	作用	示例值
--model	选择修复模型	lama/zits/manga
--device	跑在 CPU 还是 GPU 上	cpu/cuda
--port	Web 界面端口	8080
--model-dir	模型下载目录	~/models/iopaint
--enable-interactive-seg	打开 SAM 交互式分割，mask 标得更准	需要时加上
--interactive-seg-model	指定交互式分割用哪个 SAM 模型	sam2_1_tiny
--enable-gfpgan	打开人脸恢复插件	需要时加上
--concat	批量时把原图、mask、结果拼成一张	true

不确定就用默认值，先跑通一张图，再回头调参数。

踩坑与补救

现象：修复区域发虚，纹理断掉。原因：mask 太薄，AI 拿到的周围参考区域不够。解法：把画笔调大，覆盖比水印略大的区域，重新修复。

现象：单张图处理要等好几分钟。原因：跑在 CPU 上，没有用到显卡。解法：装好 CUDA 版 PyTorch 后，用iopaint start --model=lama --device=cuda重启。

现象：水印边缘还有淡淡残影。原因：第一次涂抹没盖住水印的羽化边缘。解法：换小画笔对准残留区域补涂，再跑一次修复。

现在就去试

1. pip3 install iopaint
2. iopaint start --model=lama --device=cpu --port=8080
3. iopaint run --model=lama --device=cpu --image=./input --mask=./mask --output=./out

跑完打开浏览器，先修出第一张图。

【免费下载链接】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