企业官网建设流程全解析

零配置起步: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 图像修复(inpainting)工具:用笔刷涂出要处理的区域,它会自动补全画面,完成水印去除、物体移除乃至换内容。它完全免费,一条命令即可在本地跑起来,项目采用 Apache 2.0 许可证开源,可自由使用。

从安装到看到第一张修复结果

三个系统各一条最短路径,全程 3 分钟内可出第一个结果。

Windows:克隆仓库后双击脚本即可:

git clone https://gitcode.com/GitHub_Trending/io/IOPaint cd IOPaint

双击scripts/user_scripts/win_setup_cn.bat安装(脚本内置国内镜像),再双击win_start_cn.bat启动。

macOS / Linux:

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

首次启动会自动下载 lama 模型,之后启动即复用。

你会看到什么:浏览器打开http://localhost:8080的网页界面,上传一张图,用左侧画笔在路人身上涂出黑色蒙版,点修复按钮,几秒后蒙版区域被自然填充,结果以新文件形式保存到输出目录。

三个常见修复场景:水印去除、物体替换、文字编辑

按你想解决的问题选模型,而不是按模型名字记参数。

场景一:去掉路人、水印、多余文字。痛点是这类目标与背景纹理接近,手动画布很难无痕。选--model=lama,它不依赖文字描述,默认参数即可;蒙版尽量贴合目标边缘,2000px 内图像在 GPU 上单次推理约 1~2 秒。

场景二:替换物体或扩展背景。只擦除无法满足时(比如把灯笼换成花瓶、把画面往四周补全),需要扩散类模型。选--model=PowerPaint,在 prompt 里描述要替换的内容,去噪强度(denoising strength)从 0.4 起步:越低越贴近原图,越高越听 prompt 的。

场景三:给图片添加或修改文字。AnyText 是专门做图中文字的模型,输入目标文字即可生成与画面透视、字体风格匹配的文本,适合做海报式改字;模型体积较大,建议 GPU 环境运行。

模型选型与调参决策表

拿不准时直接用默认值:擦除选 lama,扩散类选 PowerPaint,采样步数保持默认;结果不满意再逐项动参数,而不是同时改多个。

进阶:批量图像修复与插件系统

命令行可直接批量处理,无需打开网页:

iopaint run --model=lama --device=cpu \ --image=图片目录 \ --mask=蒙版目录 \ --output=输出目录

--mask是目录时,蒙版文件名需与源图同名;是单个文件时,该蒙版套用到所有图片。

插件在启动参数里按需打开,例如--enable-interactive-seg启用基于 SAM2 的交互式选区,把"涂蒙版"变成"点一下自动选中"。代表性实现见 iopaint/plugins/interactive_seg.py 与 iopaint/plugins/realesrgan.py,后者用于修复后的超分辨率放大。

常见故障与排查

pip 安装缓慢或失败:换国内源安装:

pip3 install -i https://pypi.tuna.tsinghua.edu.cn/simple iopaint

模型下载慢:启动前设置镜像环境变量,并用--model-dir指定磁盘空间充足的目录:

export HF_ENDPOINT=https://hf-mirror.com

Windows 下对应set HF_ENDPOINT=https://hf-mirror.com。

CUDA out of memory(显存不足):启动命令依次追加--low-mem、--cpu-offload,仍不行就换--device=cpu只跑擦除模型。

扩散模型输出全黑或全绿:追加--no-half以 fp32 精度运行,代价是耗时增加约一倍。

输出比原图模糊:修复分辨率跟随源图,若源图本身是压缩过的 JPG,先用 RealESRGAN 插件放大再修复,效果更干净。

下一步

完整参数列表见 README.md,各修复模型源码在 iopaint/model/,插件清单在 iopaint/plugins/。所有推理都在本机完成,图片不会上传到任何服务器。

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