3 步跑通 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 都能交给模型处理。IOPaint 是一个完全免费、开源的 AI 图像修复工具：框选区域即可擦除不想要的元素，也能替换物体、生成文字、扩展画面，全程在本地运行，不上传、不收费，支持 CPU、GPU 和 Apple Silicon。
能力速览：四大核心场景一次看清 🎨
IOPaint 集成了多个 SOTA 模型，四大核心能力覆盖大部分修复需求：
| 能力 | 背后模型 | 你得到什么 |
|---|---|---|
| 智能擦除 | LaMa | 框一下水印或路人，背景自动补全 |
| 对象替换 | PowerPaint | 刷选区域 + 文字描述，生成想要的结果 |
| 文字生成 | AnyText | 文字自然贴合场景透视与光影 |
| 图像扩展 | PowerPaint | 向外扩画幅，场景延续不穿帮 |
- 智能擦除：最常用的能力，涂抹掉目标区域后，LaMa 自动推断背景补全，边缘衔接自然。
LaMa 模型实现
- 对象替换：刷选住物体，输入描述文字，PowerPaint 会按你的描述重新生成这块内容，实现"所想即所得"。
PowerPaint 推理管线
- 文字生成：AnyText 不是简单贴图，而是让文字带上场景的光影和透视，解决文字叠加的违和感。
AnyText 模块
- 图像扩展：outpainting 把画幅向外延伸，做宽幅壁纸或补齐残缺构图都靠它。
PowerPaint 推理管线
这四项能力在同一个 Web 编辑器里就能用，不用在多个工具间切换。
三步跑通：从安装到第一次出图
第 1 步：安装
pip3 install iopaint一行命令装好 IOPaint 全部依赖。
第 2 步：拉起 Web 编辑器
iopaint start --model=lama --device=cpu --port=8080启动 8080 端口服务并自动下载模型。有显卡的话把--device换成cuda，推理速度会明显更快；首次启动会自动拉取模型文件，可用--model-dir指定下载目录。
第 3 步：产出第一张图
- 浏览器打开
http://localhost:8080 - 上传一张图，选擦除模型，用画笔涂掉目标区域
- 按需调整质量、迭代次数等参数，点击"运行"
跑完这条命令，浏览器里就能画框出图了 🖌️
启动参数定义
进阶玩法：五个插件各配一条启用命令
| 插件 | 一句话能力 |
|---|---|
| SAM 交互式分割 | 点选、框选任意物体，像素级取选区 |
| RemoveBG 背景移除 | 自动识别主体，输出透明底图 |
| RealESRGAN 超分 | 2-4 倍放大，修复模糊细节 |
| GFPGAN 人脸修复 | 老照片人脸变清晰，特征不跑偏 |
| Anime Seg 动漫分割 | 专为动漫训练的分割，角色/背景分离更准 |
- SAM 交互式分割：给插件装上"手"，让取选区不再靠纯手工描边。
iopaint start --enable-interactive-seg --interactive-seg-device=cuda启用交互式分割插件。segment_anything 插件
- RemoveBG 背景移除：产品图、人像图直接得到透明背景。
iopaint start --enable-remove-bg --remove-bg-device=cuda启用背景移除插件。
remove_bg 插件实现
- RealESRGAN 图像超分：模糊老图放大后细节不糊。
iopaint start --enable-realesrgan --realesrgan-device=cuda启用超分插件。RealESRGAN 插件实现
- GFPGAN 人脸修复：老照片里糊掉的脸，修复后五官清晰。
iopaint start --enable-gfpgan --gfpgan-device=cuda启用人脸修复插件。
GFPGAN 插件
- Anime Seg 动漫分割：漫展返图批量抠角色，精度比通用分割更高。
iopaint start --enable-anime-seg启用动漫分割插件。
anime_seg 插件实现
给同一条启动命令加上开关即可，不用另外装工具。
百张图批量擦除的命令行写法
不想一张张点界面？run子命令直接吃整个文件夹：
iopaint run --model=lama --device=cpu \ --image=/path/to/image_folder \ --mask=/path/to/mask_folder \ --output=output_dir按同名配对处理整个文件夹。
参数说明：
--image：原图文件夹（也支持单张文件）--mask：遮罩文件夹，文件名需与原图一致；传单个文件则所有图共用同一张遮罩--output：结果输出目录--model/--device：指定擦除模型与计算设备- 遮罩尺寸不一致会自动缩放；加
--concat还能导出原图 + 遮罩 + 结果三联对比图
批量处理实现
写一条命令，整文件夹的擦除任务就可以挂机跑完。
部署与二次开发：Docker 镜像和源码编译
Docker 双镜像：CPU / GPU 各一条命令
# CPU 版本镜像 docker build -f docker/CPUDockerfile -t iopaint-cpu . # GPU 版本镜像 docker build -f docker/GPUDockerfile -t iopaint-gpu .把依赖打包成开箱即用的容器镜像。
Docker 配置文件
源码编译：想改前端代码再走这条路
git clone https://gitcode.com/GitHub_Trending/io/IOPaint cd IOPaint/web_app npm install && npm run build # 构建前端 cd .. pip install -r requirements.txt python3 main.py start --model lama --port 8080装好前后端依赖并启动开发服务。
前端开发说明
现在就跑一遍"三步跑通"，几分钟内你也能拥有本地跑的 AI 修图服务；更多模型清单与参数细节，看这份完整文档：README.md
【免费下载链接】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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
