IOPaint本地消除物体20分钟免费跑通【免费下载链接】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 自动补全背景也能用扩散模型替换画面。在 Windows 本机完成安装并打开消除界面全程约 20 分钟。新手最常卡住的是 Python 版本和首次启动下载模型。下文按自查、安装启动、故障排查、进阶推进。IOPaint 安装前自查你的机器能不能跑装之前核对五项每项都有明确通过值不通过先解决再进安装。检查项验证方式通过标准不通过怎么办Python 版本执行python -V显示 3.10.x安装 3.10安装时勾选 Add Python to PATH系统盘剩余空间文件管理器查看系统盘≥ 10GB清理磁盘或改装到其他盘端口 8080执行netstat -ano看输出是否含 8080 与 LISTEN8080 无 LISTEN 记录启动时改用--port 8081网络浏览器访问 pypi.org页面能打开或准备国内镜像源安装前先配置清华镜像显卡驱动执行nvidia-smi显示 NVIDIA 驱动与显卡信息无独立显卡也通过--devicecpu可跑消除模型按顺序安装从零到打开界面建好 3.10 虚拟环境做完后终端出现 (venv) 前缀目标终端处于 Python 3.10 的独立虚拟环境中pip 走稳定镜像。操作安装 Python 3.10.x安装时勾选 Add Python to PATH否则命令行找不到解释器。执行python -m venv venv在当前目录创建一个与系统隔离的虚拟环境。执行venv\Scripts\activateWindows 路径激活环境。国内网络执行pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple把 pip 切到清华源避免下载停滞。通过信号提示符前出现(venv)且python -V输出 3.10.x。不符合时直接看第 3 部分。装好 IOPaint做完后命令行能跑出启动参数目标主程序与依赖 PyTorch 全部就位iopaint命令可用。操作执行pip install -U iopaint安装主程序PyTorch 作为依赖一并拉取它是最大的单个包等它跑完。执行iopaint start --help验证命令已注册应输出启动参数列表。通过信号第二条命令列出--model、--port等参数无红色报错。不符合时直接看第 3 部分。启动 Web 服务做完后浏览器打开消除界面目标服务监听 8080lama 模型完成首次自动下载并加载。操作执行iopaint start --modellama --devicecpu --port8080。首次启动会自动把 lama 模型下载到默认缓存目录终端出现下载进度属正常现象不要关窗口。参数作用推荐值--model加载哪个模型lama轻量擦除CPU 可用--device计算设备cpuNVIDIA 显卡且装好 CUDA 版 PyTorch 时填cuda--port服务端口8080被占用时改8081--model-dir模型存放目录默认即可需固定位置时填本地绝对路径通过信号终端停止下载、服务启动浏览器打开http://localhost:8080出现图片上传与画笔界面。不符合时直接看第 3 部分。验证消除功能做完后看到水印消失的结果图目标走通「上传 → 涂抹 → 消除」的端到端流程。操作界面上传一张带水印的照片可先用仓库里的示例图用画笔涂满水印区域点击消除等待结果生成。通过信号界面输出结果图、涂抹区域的水印消失且终端无报错。同一张照片经 IOPaint 消除后的效果如下未出图或终端报错时直接看第 3 部分。界面打不开时最常见故障速查pip 下载长时间停滞— 判断默认源在国外带宽受限处理执行pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple后重新运行安装命令。安装时依赖解析或版本报错— 判断Python 不是 3.10.x处理装好 3.10.x删除 venv 目录重新创建并激活再跑安装命令。start 后终端长时间没有 Web 地址— 判断首次正在下载 AI 模型处理保持终端开启等下载完成并打印访问地址不要杀进程。浏览器访问 8080 被拒绝— 判断端口被占用或服务已退出处理看终端报错再用iopaint start --modellama --port8081重启。出现 CUDA / cuDNN 相关报错— 判断装了 CUDA 版 PyTorch 但显卡驱动过旧处理升级显卡驱动或先用--devicecpu排除环境问题。模型下载中断— 判断网络不稳处理直接重跑 start 命令即可模型支持续传无需手动清理缓存。⚠️ 镜像源只配 1–2 个配多了反而导致依赖解析混乱。按流程操作后预期总耗时约 15–30 分钟首次含模型下载二次启动为秒级。装完之后去哪批量消除不用界面终端一条命令处理整批照片遮罩白色区域即待消除区域例如去掉背景人物iopaint run --modellama --devicecpu --imageimages --maskmasks --outputout模型缓存复用与多机部署模型只下载一次之后iopaint start直接走本地缓存启动仅需数十秒需要固定位置时加--model-dir多机部署可直接拷贝该目录。想用仓库内的 Windows 一键脚本时先克隆仓库git clone https://gitcode.com/GitHub_Trending/io/IOPaint资源索引项目总览与快速开始README.mdWindows 安装与启动脚本scripts/user_scripts/中文安装脚本预置两条镜像源win_setup_cn.bat后端依赖清单requirements.txt前端界面源码web_app/src/挑一张带水印的照片上传到界面里消除一次安装是否真正跑通两分钟就能验证。【免费下载链接】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），仅供参考