IOPaint 安装教程：15 分钟在 Windows 上免费跑起 AI 消除工具

IOPaint 安装教程15 分钟在 Windows 上免费跑起 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 首次启动有个新手最容易慌的点命令敲完终端长时间不动看起来像卡死了——其实它在后台下载模型。这篇教程带你把 Windows 上的 IOPaint 安装完整走一遍配置 Python 3.10 环境、启动 Web 界面、真实跑一次图片去水印全程免费、无硬件门槛预留 15 分钟左右即可。动手前先确认你的电脑先花一分钟核对三项条件不用装任何东西Python 版本。打开终端Windows 搜索框输入cmd回车执行python -V这条命令查询当前解释器版本。输出3.10.x算通过其他版本或提示不是内部命令都不算通过需要先装 Python 3.10安装器界面记得勾选 Add Python to PATH。磁盘空间。系统盘剩余 ≥ 10GB 算通过依赖和模型文件加起来不小。端口。默认使用 8080。如果本机已有服务占着它不算通过但无需卸载——启动时加--port换个端口即可。创建并激活 Python 3.10 虚拟环境在存放 IOPaint 的目录下先建一个隔离环境装包就不会污染系统python -m venv venv在当前目录创建一个名为venv的干净虚拟环境。然后激活它venv\Scripts\activate激活成功的标志是终端提示符行首出现(venv)。如果你在国内网络环境可以先把 pip 切到清华镜像源装依赖会快很多该配置只作用于 pip不影响系统其他软件pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple接着安装 IOPaint 主程序PyTorch 会作为依赖一并拉下来pip install -U iopaint启动 Web 界面并验证消除效果环境就绪后在虚拟环境中执行启动命令拉起 Web 服务iopaint start --modellama --devicecpu --port8080这条 iopaint start 启动命令做了三件事加载 lama 轻量消除模型、用 CPU 计算、把服务挂在 8080 端口。几个参数的取舍参数作用建议值--model加载哪个模型消除场景用lama即可CPU 也能跑--device计算设备默认cpu只有装了 CUDA 版 PyTorch 的 NVIDIA 显卡才用cuda--port服务端口8080被占用就改成8081--model-dir模型文件存放位置默认缓存目录即可想固定位置时再填⚠️ 首次启动会自动下载 lama 模型到默认缓存目录终端显示进度条期间请耐心等待不要关窗口——这一步不是故障。下载完成后浏览器打开http://localhost:8080上传一张测试图用画笔涂抹背景中多余的人点击消除结果图生成、终端无报错即算安装通过。有水印、多余物件或文字的图也可以顺手试试如果卡住了五个常见症状pip 下载长时间停滞→ 大概率是默认源在海外。执行上面的pip config命令切到清华源后重新执行pip install -U iopaint。Python 版本或依赖解析报错→ Python 不是 3.10。装好 3.10 后删除venv目录重新python -m venv venv再装。start 之后终端迟迟没有 Web 就绪提示→ 首次正在下载模型。保持终端开着等进度走完。浏览器访问 8080 被拒绝→ 端口被占用或进程已退出。先确认终端还活着不行就加--port8081重启。CUDA / cuDNN 报错→ 装了 CUDA 版 PyTorch 但显卡驱动过旧。升级驱动或先退回--devicecpu把流程跑通。装好之后多知道一点点批量处理不用打开网页。准备原图文件夹和遮罩文件夹白色区域即待消除区域后执行iopaint run --modellama --devicecpu --imageimages --maskmasks --outputout--image指向原图目录--mask指向对应遮罩目录--output是结果输出目录若--mask传单个文件则同一遮罩套用到所有图片。镜像源别贪多。建议只配 1–2 个稳定源配太多反而可能解析混乱。仓库里的 win_setup_cn.bat 预置了清华源与腾讯云源两条镜像可以直接当配置模板参考。模型只下载一次。第二次iopaint start直接走本地缓存启动耗时降到几十秒。多台机器部署时可以加--model-dir指定目录再把这个目录整体拷走若要用到仓库内脚本先执行git clone https://gitcode.com/GitHub_Trending/io/IOPaint把仓库克隆下来。装完立刻能做的事挑一张带水印的照片打开http://localhost:8080涂抹水印跑一次消除——这是检验安装是否成功最直接的姿势。延伸阅读仓库内文件项目总览与命令入口README.md后端依赖清单requirements.txtWindows 一键脚本说明scripts/README.md启动脚本win_start.bat国内镜像配置模板win_setup_cn.bat【免费下载链接】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），仅供参考