IOPaint AI修图教程：10分钟本地跑通图片去物修图工具

IOPaint AI修图教程：10分钟本地跑通图片去物修图工具

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

想从照片里抠掉一个路人，是不是还得靠 PS 一点点修补？IOPaint 是免费开源的 AI 修图工具：本地运行，能擦除图片中的物体、水印、人物，也能用扩散模型替换和扩展画面。装好只需 2 条命令。

项目速览

先说清楚它能干什么，以及每块能力对你的价值：

表1：IOPaint 功能与价值对照

快速上手

你只需要一样东西：Python（3.7 以上，推荐 3.10）。不需要 GPU，纯 CPU 的电脑也能跑。从安装到跑通只要 2 条命令：

# 第一步：安装 IOPaint AI 修图工具 pip3 install iopaint # 第二步：启动网页端界面（默认 LaMa 模型、CPU、8080 端口） iopaint start --model=lama --device=cpu --port=8080

代码1：本地启动 IOPaint 的 2 条命令

浏览器打开http://localhost:8080即可使用。首次启动会自动下载 LaMa 模型（约 200MB），下载完会缓存到本地，之后启动不再重复下载；想换存放位置可加--model-dir参数。

实操流程

三个场景共用同一套界面：左侧画布放图，右侧参数面板选模型。区别只在模型选择和刷笔方式。

场景1：擦除不想要的物体

场景：照片里有个不该入镜的路人、垃圾桶或者电线杆。

操作：载入图片 → 点左侧画笔工具 → 在物体上刷出红色蒙版（蒙版就是"要擦掉的区域"）→ 点右侧"生成"。

效果：LaMa 用 1~2 秒把蒙版区域按周围纹理补全，小物件修完基本看不出痕迹。

图1：IOPaint 物体擦除前的示例图，红框区域即待擦除对象

场景2：去除水印

场景：想用的图上压着 Logo 或文字水印。

操作：同样用画笔刷出水印，蒙版要把水印连同边缘虚化部分一起盖住；宁可刷大，不要刷小。

效果：半透明水印是 IOPaint 最稳的场景，修完的背景通常可以直接交付。

图2：IOPaint AI 修图工具去除水印前的图片

场景3：替换物体，而不只是擦掉

场景：想把图里的椅子换成沙发，而不是让椅子消失。

操作：换成扩散模型（需要 GPU），刷出要替换的区域，在提示词框输入描述，点生成。

# 切换到 PowerPaint 模型，支持"擦除+替换"，需 CUDA 显卡 iopaint start --model=Sanster/PowerPaint-V1-stable-diffusion-inpainting --device=cuda

代码2：用扩散替换模型启动 IOPaint

效果：单张生成约 20~40 秒，新物体的光影、透视和原图保持协调。

效果验证

下面是普通桌面机器的单张耗时参考，方便你估算等待时间：

表2：IOPaint 各任务耗时对比（不同机器有差异）

擦除前后的直观对比：

图3：IOPaint 物体擦除后的效果，背景补全自然无明显接缝

避坑清单

第一天使用最容易卡住的 5 个问题，大多靠一个参数就能解决。

问题：首次启动卡在下载模型很久？解法：模型有本地缓存，第二次启动即开即用；用--model-dir把缓存挪到空间大的盘，避免占满 C 盘。

问题：替换物体时生成结果发黑或发绿？解法：启动命令加--no-half，强制全精度计算。

问题：显存不够跑扩散模型？解法：加--cpu-offload把模型权重移到内存，或加--low-mem开启低内存模式。

问题：想批量修一整个文件夹的图？解法：不必开网页端，直接用iopaint run命令：--image指向原图文件夹、--mask指向蒙版（蒙版是单张时所有图共用）、--output指定输出目录。

问题：模型下载慢？解法：Windows 用户可参考 scripts/user_scripts/ 下的现成脚本，已配置国内 pip 镜像并设置模型下载加速环境变量，双击即可执行。

一句话总结：IOPaint 让本地 AI 修图从"想装它"到"修完一张图"只需要 10 分钟。更多材料：

• 项目说明与完整功能列表：README.md
• Windows 一键安装脚本：win_setup_cn.bat
• 命令行全部参数（含批量处理）：iopaint/cli.py

现在就挑一张有杂物的照片刷一笔，点"生成"吧。

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