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，即"擦除后自动补全"）工具，面向不熟悉图像编辑软件的新手和普通用户。它内置多款 SOTA（state-of-the-art，意为当前研究水平最领先）的 AI 模型，可以完成图片去水印、移除画面中的物体或人物、清理漫画文字等任务，全部在本地运行。
三个高频使用场景
场景一：去掉照片水印
把需要处理的水印区域用画笔涂抹标记，模型会根据周围像素补全背景。以下示例中，人物照片上大面积重复的图库水印被完整清除，肤色与车窗反光都保持了自然过渡。
场景二：移除不想要的物体和人物
物体移除的逻辑与水印一致：涂掉目标，模型重建被遮挡的部分。示例一是一张木结构场馆照片，顶部几盏白色灯笼被移除后，木质屋顶横梁的结构被合理补全。
示例二是移除背景里的路人：前景人物保持不动，背景中的行人被干净地消除。
场景三：漫画与文字清理
漫画扫描版常带有文字框和扫描噪点，把文字区域标记后，模型会重建底层的网点与线条。
游戏截图上的大标题文字同样适用，擦除后背景的云层与光效得以还原。
安装与启动
Windows 一键安装
先克隆仓库（仅此处使用仓库地址）：
git clone https://gitcode.com/GitHub_Trending/io/IOPaint cd IOPaint然后按顺序操作：
- 双击运行
scripts/user_scripts/win_setup_cn.bat，脚本会配置 Python 环境、走国内镜像源下载依赖，并自动检测 NVIDIA 显卡以配置 CUDA。 - 双击运行
scripts/user_scripts/win_start_cn.bat启动服务。 - 浏览器打开
http://localhost:8080，即可在 Web 界面里画遮罩、选模型并查看结果。
macOS 与 Linux 一行命令启动
这两个系统可以直接通过 pip 安装：
pip3 install iopaint iopaint start --model=lama --device=cpu --port=8080首次启动时所需模型会自动下载，之后即可访问同一地址使用。
按场景选修复模型
不同模型取向不同，按下表选择即可，启动时用--model参数指定：
| 使用场景 | 推荐模型 | 特点 |
|---|---|---|
| 快速擦除（水印、小物体） | LaMa | 速度快、结果自然，覆盖大多数日常需求 |
| 高质量修复（大面积、复杂背景） | Stable Diffusion（--model=sd） | 基于扩散模型生成细节，修复更精细 |
| 在图中添加或修改文字 | AnyText | 面向文字编辑场景的专用模型 |
| 扩展图像边界 | PowerPaint | 向外填充画面，用于扩展构图 |
以 GPU 运行 Stable Diffusion 为例：
iopaint start --model=sd --device=cuda进阶：批量处理与插件
批量处理
需要一次处理大量图片时，可用run子命令，按目录批量读取图片与对应遮罩：
iopaint run --model=lama --device=cpu \ --image=/path/to/image_folder \ --mask=/path/to/mask_folder \ --output=output_dir插件系统
Web 界面附带四个可选插件，源码位于 iopaint/plugins/：
- interactive_seg.py：交互式分割，帮你精确圈出要编辑的区域
- remove_bg.py：自动移除背景
- realesrgan.py：超分辨率，提高图像清晰度
- gfpgan_plugin.py：人脸修复，改善人脸细节质量
启动时通过参数启用，例如：
iopaint start --enable-interactive-seg --interactive-seg-device=cuda常见问题速查
Q1：Windows 安装脚本失败怎么办？
- 以管理员身份运行安装脚本。
- 检查网络，确认可访问国内镜像源。
- 暂时关闭杀毒软件后重试。
Q2：模型下载缓慢怎么办？默认已配置国内镜像加速。如仍偏慢，可手动设置环境变量：
set HF_ENDPOINT=https://hf-mirror.comQ3：运行时内存或显存不足？
- 改用 CPU 模式：
iopaint start --device=cpu。 - 添加
--low-vram参数降低显存占用。 - 关闭其他占用内存的程序。
Q4：如何更新到最新版本？
pip3 install -U iopaint写在最后：数据不出本机
IOPaint 的所有推理都在本机完成，图片不会上传到任何服务器，这一点在处理证件照、工作素材时尤其重要。如需深入了解实现，可以直接阅读项目内的文档与源码：
- 官方说明：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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
