IOPaint Windows 快速安装教程4 个高频卡点逐个击破本地 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/IOPaintIOPaint 是一款开源的本地 AI 修图工具擦除图片里的物体、水印、路人或用 Stable Diffusion 重绘替换任意内容。这篇 IOPaint 快速安装教程面向 Windows 用户走通一键安装全流程并把下载卡死、模型拉不动这类卡点逐条给出解法。装完能做什么AI 修图的三类任务安装完成后的样子很简单浏览器打开一个本地页面上传图片、涂一下要处理的区域、点生成。具体能干三类活。擦除物体、水印和文字最常用的一类。涂上想去掉的部分LaMa 这类模型会把背景补全。下面这组图是仓库素材里的真实效果图1含多余物体的原图图2擦除后的结果背景被模型自然补全重绘替换与向外扩展想更进一步可以换 Stable Diffusion 系模型指定提示词把被涂抹区域换成别的内容或者把画面向外扩出去补全outpainting。这类模型体积在几个 GB 量级首次使用会现下载属于本文后面要讲的慢的主要来源。安装前 1 分钟检查要不要自己装 Python 环境不用。一键安装包内置了 conda 环境环境定义见 scripts/environment.yamlPython 3.10、git、git-lfs解压即用。⚠️ 所以别提前去装别的 Python 版本反而容易互相干扰。磁盘空间和显卡预留至少 10 GB 给环境和模型装多了扩散模型会占更多。显卡不是必须没有 NVIDIA 显卡也能用 CPU 跑只是出图更慢有显卡则建议驱动较新因为脚本里固定了 CUDA 11.8 版本的 PyTorchtorch 2.1.2。主线安装三步从压缩包到打开网页第一步解压一键安装包约几分钟从项目官方发布渠道下载 Windows 一键安装包下载地址在 scripts/README.md 里解压到一个不带中文和空格的路径比如D:\iopaint确认能看到installer\环境目录和 win_setup_cn.bat 等脚本仓库中对应 scripts/user_scripts/ 目录第二步运行国内版安装脚本耗时主要看网速双击 win_setup_cn.bat脚本会依次做四件事激活内置环境 → 把 PyPI 源写到清华 腾讯云双镜像 → 安装 CUDA 11.8 版 PyTorch → 安装 iopaint 主体和插件依赖窗口停在请按任意键即完成 ✅带_cn后缀的都是国内网络友好版全程用_cn系列即可不要混用英文版脚本。第三步启动服务并打开本地页面首次含模型下载双击 win_start_cn.bat首次启动会自动下载默认模型窗口有滚动输出属正常耐心等它结束浏览器访问http://localhost:8080能看到编辑页即大功告成卡点逐个击破现象 → 原因 → 一招解决现象依赖下载长时间不动原因默认 PyPI 源在国内访问不稳定PyTorch 又大进度条容易假死解决这就是_cn脚本存在的意义——它把清华和腾讯云镜像直接写进了 pip 全局配置。你如果误跑了英文版 win_setup.bat 卡住关掉窗口改跑_cn版重续即可现象服务起来了但模型下载失败原因模型文件托管在 HuggingFace国内直连成功率低解决win_start_cn.bat 在启动前会把模型下载端点指向国内镜像站。用_cn启动脚本就自动生效无需手动改任何环境变量 ⚠️ 如果你看到的是英文启动脚本导致的失败别去系统里手动加环境变量换_cn脚本重跑最干净现象浏览器打不开 8080 页面原因多半是服务还没起来或端口被占用解决回看启动窗口的最后一行——还在下载模型就继续等报了端口占用就在启动参数里把--port换成别的端口再访问对应地址现象想用 GPU实际跑在 CPU 上原因没装上 CUDA 版 PyTorch或显卡驱动与 cu118 不匹配解决安装脚本已固定装 CUDA 11.8 的 torch一般不用动。真不匹配时先降级到--devicecpu保证能用再单独排查驱动。装完之后的进阶配置用网页配置页改默认参数双击 win_config.bat会打开一个网页配置页用来改安装配置文件里的默认模型、端口等参数改完下次启动自动生效不用碰命令行。升级版本双击 win_update.bat一条命令把 iopaint 升到最新版几分钟后重新启动即可。离线部署到第二台机器在第一台机器上装好并跑过一次此时模型已缓存在本地把整个安装目录连同模型缓存目录打包拷贝过去在目标机上直接双击win_start_cn.bat模型不再走网络就像提前备好的食材第二台机器上基本免下载。图3处理前图片右下角有明显水印图4处理后水印区域被模型补全资源导航常用文档与脚本目录项目总览与命令参考README.mdWindows 一键安装说明scripts/README.md全部安装/启动/更新脚本scripts/user_scripts/内置环境定义Python 版本依据scripts/environment.yaml前端页面开发文档web_app/README.md装好 IOPaint 只是开始从第一张要去水印的图开始练手遇到卡点回本文对照现象 → 原因 → 解决逐条排查大部分问题十分钟内都能闭环。【免费下载链接】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），仅供参考