如何15分钟装好IOPaint：零基础跑通AI修图

如何15分钟装好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是一款基于SOTA模型的免费开源AI修图工具，能一键擦掉照片里的水印、路人、杂物。刚拍完的照片上多了个路人，想删掉却发现P图软件越抠越假——这种时刻它就派上用场了。按本文操作，大约15分钟，你也能在自己的电脑上跑起来。

一、动手前先花30秒自检（30秒）

开始之前，先确认4件事，每项没过都会拖慢进度：

1. 磁盘空间：C盘剩 10GB 以上。不够的话，PyTorch 和模型会下载到一半直接报错，前功尽弃。
2. Python 环境：装没装过都没关系，一键脚本会自带 Python 3.10，不用你操心。
3. 网络环境：家里宽带、4G 热点都能跑，但脚本要能访问清华、腾讯云的镜像源（国内速度很快）。
4. 显卡：有 N 卡最好，没有也行，CPU 模式完全可用，只是处理时慢一点。

装完能干嘛？先看两张实际效果图：

图1：IOPaint去除照片水印前后的画面，老照片上的水印被完整擦除

图2：IOPaint去除照片中多余物体，画面干净且背景衔接自然

二、分阶段实操：从下载到启动（约12分钟）

阶段A：拿到项目（2-3分钟）

1. 打开命令提示符（按Win+R，输入cmd回车）。
2. 把项目下载到本地，命令如下：

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

3. 确认进入了user_scripts目录，里面有一批.bat脚本，中文后缀的就是为我们准备的。

阶段B：跑安装脚本（5-10分钟）

1. 找到win_setup_cn.bat，直接双击就行，不用管它。
2. 脚本会自动做三件事：激活内置环境、把 pip 下载源切成清华和腾讯云镜像（下载速度快了十几倍）、安装 PyTorch 和 IOPaint 本体。
3. 中途如果某一步网络波动失败，它会提示"10秒后重试"，最多自动重试5次，别慌，让它自己跑完。

⚠️ 脚本里还内置了 HF_ENDPOINT 等环境变量配置，说白了就是"模型去哪下载"的开关，已经指向国内镜像了，你不需要手动改任何系统设置。

阶段C：验证跑通（1-2分钟）

1. 双击win_start_cn.bat启动服务。
2. 看到终端输出启动信息后，浏览器访问http://localhost:8080，能打开界面就算成功。
3. 随便传一张图，用画笔涂掉一块区域，选默认模型点运行——第一次会下载 LaMa 模型，稍等片刻，出图即通。

💡 模型下载一次后会缓存在本地，之后重启启动几乎是秒开，第二次配置其他电脑时还能直接拷缓存。

三、装完之后到底有多快？

关键发现：真正的大头不是脚本执行时间，而是模型下载。镜像源 + 本地缓存这两招，把"等下载"变成了"秒启动"，二次安装基本 5 分钟内搞定。

四、装完只是开始——3个进阶玩法

玩法1：去水印（图形界面）

1. 打开http://localhost:8080，上传带水印的图片。
2. 用画笔把水印区域涂黑，模型选默认的 LaMa。
3. 点运行，几秒钟就得到干净画面。

图3：IOPaint去除图片上的多余文字，原始设计保留完整

玩法2：批量处理（命令行）

要处理一整个文件夹的照片，直接在终端跑一条命令：

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

蒙版文件和原图同名即可，脚本会逐张处理完自动存到输出目录，几百张图不用盯着看。

玩法3：换模型玩智能填充

把--model=lama换成 SD 系列扩散模型（如--model=sd_15_inpaint），就能"擦掉+重画"：把路人擦掉，同时根据提示词补上合理背景，比单纯修补更智能。

💡 还可以按需开启这些插件扩展：

• Segment Anything：交互式点选物体，精确生成分割蒙版
• RemoveBG：一键去背景或生成前景蒙版
• RealESRGAN：低清图 4 倍超分放大
• GFPGAN：人脸修复和增强

图4：IOPaint对旧漫画图像的划痕修复演示

五、遇到问题？按这个顺序排查

症状1：pip 下载慢或反复失败先别重头再来，看终端最后一行卡在哪个包。检查脚本里 pip 的 extra-index-url 是否还指向清华/腾讯云镜像，确认后重新双击win_setup_cn.bat即可，它会自动续装。预期：几分钟后完成。

症状2：双击启动脚本，窗口一闪而过打开命令提示符，cd到user_scripts目录后再运行win_start_cn.bat，错误信息就会留在窗口里。常见原因是没在正确目录运行。预期：能看到具体报错，按提示补上对应步骤。

症状3：启动卡在"downloading model"第一次启动必须下载模型，网络差时显得像卡死。确认它不是真死机（终端有滚动日志就是活着），耐心等；下载完模型缓存在本地，下次启动不会再下。预期：等一次，之后秒过。

症状4：界面打不开看终端里实际监听的端口（默认 8080），浏览器地址要用http://localhost:8080，别打成 https。预期：地址对了页面就出来了。

六、收尾

一条win_setup_cn.bat+ 一条win_start_cn.bat，就是你从零基础到用上 AI 修图的全部距离。遇到问题按第五节的顺序查，基本都能自己解决。

• 官方README：README.md
• 脚本说明：scripts/
• 模型源码目录：iopaint/model/
• 命令行完整参数：iopaint/cli.py

现在打开终端，试试git clone那条命令吧。

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