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/IOPaintAI 图像修复类工具最大的劝退点往往不在功能而在环境Python 版本、显卡依赖、模型文件下载任何一步卡住都得推倒重来。IOPaint 是一款完全开源、可本地自托管的 AI 图像修复与扩图工具抹掉照片里的物体、水印、路人或用扩散模型替换、补全画面内容都能在浏览器界面里完成。本文手把手带你从装好环境到跑通第一张修复图并覆盖模型切换、批量处理与插件启用全程以可验证的结果为准。安装步骤Windows 环境配置与启动先确认硬件底线Windows 10/11、内存 8 GB 以上推荐 16 GB想跑扩散模型建议配 NVIDIA 显卡首次启动会联网拉取模型文件网络要通畅。获取代码。克隆仓库并进入目录git clone https://gitcode.com/GitHub_Trending/io/IOPaint cd IOPaint验证标准目录下能看到scripts/、iopaint/、web_app/等文件夹。双击运行scripts/user_scripts/win_setup_cn.bat。该脚本会在项目内创建 Python 虚拟环境并装好依赖脚本内部逻辑激活虚拟环境 → 将 pip 全局源指向清华/Tencent 镜像 → 安装 CUDA 版 PyTorchtorch 2.1.2 cu118→pip3 install -U iopaint→ 执行iopaint install-plugins-packages预装插件依赖。验证标准命令窗口走完流程后停留在PAUSE无红色报错。双击运行scripts/user_scripts/win_start_cn.bat启动服务。脚本会先设置HF_ENDPOINThttps://hf-mirror.com用国内镜像加速 HuggingFace 模型下载然后读取scripts/installer_config.json中的配置调用iopaint start。浏览器打开 http://localhost:8080 出现 IOPaint 的编辑界面即代表部署成功。首次启动模型会自动下载期间界面会等待属正常现象。不想用脚本的话也可以在装好 Python 的环境里执行pip3 install iopaint再运行iopaint start --modellama --devicecpu --port8080效果等价。上手任务移除照片里多余的物体目标把下面这张图中悬挂的粉色灯笼抹掉画面自动补全木纹与背景。在界面左上角上传assets/unwant_object.jpg任意照片都可以。选择画笔工具调大笔刷把粉色灯笼整个涂抹成遮罩涂多了再擦掉一点保证遮罩只覆盖要移除的部分。右侧保持默认模型 Lama直接点击生成。等待约几秒原图位置被擦除的灯笼由周围纹理补全背景光斑自然衔接。对结果不满意就重新涂抹再试满意后点保存文件会写入项目配置的输出目录。第一次跑通这个流程说明安装、模型、浏览器三条链路都已打通。进阶用法模型配置、批量处理与插件扩展擦除模型与扩散模型怎么切换日常抹东西用擦除模型即可需要生成新内容、替换物体、扩展画布时才上扩散模型二者速度差异很大任务类型模型特点源码位置移除物体、水印、缺陷lama默认速度快CPU 可跑iopaint/model/lama.py内容替换、修复、扩图runwayml/stable-diffusion-inpainting依赖提示词需 GPU 体验更好iopaint/model/sd.py在图中绘制文字Sanster/AnyText专攻文字生成iopaint/model/anytext/高质量修复与扩图PowerPaint基于 SD 微调iopaint/model/power_paint/切换只需改启动参数例如iopaint start --modelsd --devicecuda本地已有的 SD ckpt/safetensors 文件也能直接加载。已下载过的模型可用iopaint list查看。批量处理用法处理成批图片时不必开界面用命令行一次跑完--image指图片文件夹--mask指与图片同名的遮罩文件夹也可指定单张遮罩文件复用给所有图片iopaint run --modellama --devicecpu \ --imageinput_images \ --maskmasks \ --outputoutput_results实现在 iopaint/batch_processing.py还可用--concat把原图、遮罩、结果拼成一张对照图。启用插件插件按需开启启动参数即开关--enable-interactive-seg交互式分割、--enable-remove-bg去背景、--enable-realesrgan超分、--enable-gfpgan人脸修复并可用--gfpgan-devicecuda这类参数单独指定插件设备。全部插件入口在 iopaint/plugins/。常见问题速查8080 端口被占用启动参数加--port8081换端口浏览器同步改地址。显存不足追加--low-mem启用注意力切片与 VAE tiling或--cpu-offload把权重放到内存再不行就--devicecpu。模型下载缓慢或中断确认启动时设置了HF_ENDPOINThttps://hf-mirror.com国内镜像重启服务续传。扩散模型出图全黑/全绿加--no-half改用全精度推理。IOPaint 的安装脚本、模型与插件都集中在仓库内改任何一步都能对照源码确认。想继续深入建议按顺序阅读README.md功能清单与开发模式说明scripts/user_scripts/五个 Windows 脚本的完整逻辑iopaint/model_manager.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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考