企业官网建设流程全解析

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 自动补全了木梁与屋顶背景

快速开始：环境确认与三步启动

环境要求（不满足会怎样，逐条对应）：

• Python 3.8 及以上：低于此版本，安装 torch 2.x 依赖时会直接报错
• 内存 8GB 起步：低于 8GB 启动和修复可能卡顿甚至崩溃，4GB 机器需加--low-mem低内存模式
• 稳定网络：首次启动会自动下载模型文件，中断后需要重新下载
• NVIDIA 显卡（可选）：没有独显就以 CPU 模式运行，速度变慢但功能完整
• 预留数 GB 磁盘：擦除模型数百 MB，扩散模型更大，下载目录可用--model-dir指定

第 1 步：安装。这条命令会装好 IOPaint 及其全部 Python 依赖：

pip3 install iopaint

装完后，命令行里会出现iopaint命令，说明安装成功。

第 2 步：启动服务。下面这条命令用最快的 LaMa 擦除模型、以 CPU 模式在 8080 端口启动：

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

首次启动会先自动下载 LaMa 模型，看到"启动完成"提示即可。有 NVIDIA 显卡的把--device=cpu改成--device=cuda。

第 3 步：30 秒验证。浏览器打开http://localhost:8080，上传任意一张图，用左侧画笔圈住一个物体，点击修复按钮——几秒后圈选区域被补上，且与周围衔接自然，说明安装成功。

📝 说明：Windows 用户可以不敲任何命令。先执行git clone https://gitcode.com/GitHub_Trending/io/IOPaint拿到代码，双击scripts/user_scripts/win_setup_cn.bat自动配置环境和依赖，完成后双击scripts/user_scripts/win_start_cn.bat即可启动。

上手实测：四个常用图像修复场景

擦除物体：产品图背景杂物一次清空

遇到的问题：场地照片、产品图里总混进不想要的物件，手动修补背景纹理费时且容易留模糊边缘。

操作步骤：

1. 打开图片，在左侧工具栏选择画笔
2. 涂抹需要移除的灯笼（笔刷略大过目标即可，盖全比盖小重要）
3. 点击"修复"按钮，等待几秒
4. 保存结果，与原图对比检查边缘

得到的效果：灯笼位置被补成连续的木梁屋顶，纹理方向与周围一致，肉眼几乎看不出修补痕迹。

图：做了什么→擦除顶部纸灯笼；得到什么→背景补全为木梁结构

去水印：让带版权标记的图恢复干净

遇到的问题：从图库下载的预览图布满重复水印，直接商用不行，手动擦除会破坏主体细节。

操作步骤：

1. 打开带水印的图片
2. 用画笔逐块涂抹水印区域（浅色半透明水印可适当放大笔刷）
3. 点击"修复"
4. 放大检查人脸、车窗等细节处是否残留

得到的效果：密集的水印被整体抹平，人物的帽子、头发丝和车窗反光都保持完好。

图：做了什么→抹除遍布画面的版权水印；得到什么→干净的复古风格人像

擦除文字：海报标题说删就删

遇到的问题：游戏海报、宣传图上的大字标题无法直接覆盖，删掉后必须智能重建背后的光影。

操作步骤：

1. 打开海报图片
2. 在右侧模型选择中切换到一个更精细的擦除模型（如zits或cv2）
3. 涂抹标题文字区域
4. 点击"修复"，对比文字背后的光效是否自然

得到的效果：金色标题消失后，背后的光晕和云层由 AI 重新生成，没有留下色块或模糊带。

图：做了什么→擦除海报标题文字；得到什么→背景光效与云层自然衔接

修复漫画：对话框和音效字一键移除

遇到的问题：漫画页面需要去掉气泡对话、拟声词和注释框，传统做法要整格重画。

操作步骤：

1. 用--model=manga参数启动（或界面中切换该模型），它专为漫画场景训练
2. 涂抹需要移除的对话框与音效区域
3. 点击"修复"
4. 检查网点和线稿是否被错误重绘

得到的效果：气泡、拟声词和侧边注释全部消失，背景的网点纹理与飞机、爆炸画面完整保留。

图：做了什么→擦除漫画中的对话框与音效文字；得到什么→干净的漫画画面

适用人群速查

常见问题与避坑

现象：启动后浏览器打不开页面 →原因：8080 端口被其他程序占用，或启动命令实际失败 →解决动作：改用空闲端口重启：iopaint start --model=lama --port=8081，然后访问对应新端口

现象：首次启动长时间停在下载界面 →原因：模型文件体积大，网络不稳会反复重试 →解决动作：用iopaint list查看已下载模型确认进度；下载目录可用--model-dir改到空间充足的磁盘，或先执行iopaint download系列命令预下载

现象：机器明明有 N 卡却只用了 CPU →原因：装的是 CPU 版 PyTorch，或启动参数没写 cuda →解决动作：确认pip show torch的版本支持 CUDA，再以--device=cuda重启，观察控制台输出的设备信息

现象：处理大图时内存告警甚至崩溃 →原因：默认推理配置对低内存机器不友好 →解决动作：启动时加--low-mem（开启注意力切片与 VAE 分块），扩散类模型再叠加--cpu-offload把部分计算挪回 CPU

现象：修复后有残影或边缘模糊 →原因：掩码没盖全目标，或模型与任务不匹配 →解决动作：重画掩码确保完全覆盖目标；大面积简单背景用lama，精细结构换zits，漫画换manga

进阶玩法

批量图像修复：一条命令处理整个文件夹

什么时候需要：同一批图要做同类清理（比如几十张产品图统一去水印）。怎么开启：把原图放一个文件夹、掩码图放另一个文件夹（白色区域=要修复处，掩码文件名与图片同名；也可以给一个掩码文件让所有图共用），然后执行：

iopaint run --model=lama --device=cpu --image=images --mask=masks --output=out

命令会逐张处理并输出进度条，结果统一存到 out 目录。

换模型做内容替换，或装插件精修

什么时候需要：不是"删掉"而是"换成别的东西"（比如把白天场景换成夜晚），或者需要先精确分割出要处理的区域。怎么开启：启动时指定扩散模型，如iopaint start --model=runwayml/stable-diffusion-inpainting --device=cuda，界面中即可输入提示词生成替换内容；需要点选分割时加--enable-interactive-seg启用 Segment Anything 插件，超分和人脸修复等插件同样通过启动参数或界面开启，插件依赖可先跑iopaint install-plugins-packages装好。

⚠️ 注意：扩散类模型体积在数 GB 量级，CPU 模式处理一张图要数十秒以上，建议仅在 GPU 上使用。

写在最后

IOPaint 把"擦除"这件最耗工时的修图工作压缩成"圈一下、点一下"，而且完全免费、数据不出本机。装好之后，先从一张你最头疼的图开始试。

• 官方文档：README.md
• 各修复模型实现：iopaint/model/
• 插件源码（分割/超分/人脸修复）：iopaint/plugins/
• 批量处理脚本：iopaint/batch_processing.py
• Windows 一键安装脚本：scripts/user_scripts/

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