IOPaint 安装教程（Windows 版）：10 分钟免费跑起 AI 消除工具

IOPaint 安装教程Windows 版10 分钟免费跑起 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 安装是新手的第一道门槛它依赖 Python 3.10、PyTorch且首次启动会自动下载 AI 模型任何一环卡住都会导致 Web 界面打不开。本文按「自检 → 三阶段实操 → 故障速查 → 场景延伸」的顺序给出 Windows 上的完整路径零基础可照做。一、IOPaint 安装前 30 秒自检清单磁盘系统盘剩余 ≥ 10GB 为通过不足则清理或换盘。Python命令行执行python -V显示 3.10.x 为通过其他版本先装 3.10。网络能访问pypi.org或接受使用国内镜像源为通过。端口本机 8080 未被占用为通过否则启动时加--port换端口。二、三阶段完成 Windows 下 IOPaint 安装阶段一环境准备Python 3.10 pip 镜像约 5 分钟目标装好解释器并让 pip 走国内源。安装 Python 3.10.x安装时勾选 Add Python to PATH。打开命令行创建虚拟环境python -m venv venv。激活环境Windows 下执行venv\Scripts\activate。国内网络设置镜像源用户级配置不影响系统其他软件pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple。完成后进入安装环节。阶段二安装 IOPaint 并启动 Web 界面约 10 分钟含模型下载目标装上主程序并让服务跑起来。在虚拟环境中执行pip install -U iopaintPyTorch 会作为依赖一并安装。执行下面的命令启动服务iopaint start --modellama --devicecpu --port8080首次启动会自动下载lama模型到默认缓存目录终端出现下载进度属正常现象不要关闭窗口。关键参数说明参数作用推荐值--model指定加载的模型lama轻量擦除CPU 可用--device计算设备cpuNVIDIA 显卡并装好 CUDA 版 PyTorch 时填cuda--port服务端口8080被占用时改8081--model-dir模型文件存放目录默认即可需要固定位置时填本地绝对路径阶段三验证 IOPaint 消除功能是否可用约 2 分钟目标确认端到端流程走通。浏览器打开http://localhost:8080。上传一张测试图用画笔涂抹要去除的物体或水印点击消除。界面生成结果图且终端无报错即安装通过。三、IOPaint 安装故障速查表故障现象可能原因处理方式若出现 pip 下载长时间停滞默认源在国外访问慢用pip config set global.index-url切换清华源后重装若出现 Python 版本或依赖解析报错Python 不是 3.10.x安装 3.10.x 后删除虚拟环境重新创建若出现 start 后终端长时间无 Web 提示首次正在下载模型保持终端开启等待下载完成若出现浏览器访问 8080 被拒绝端口被占用或进程已退出加--port8081重新启动若出现 CUDA / cuDNN 相关报错装了 CUDA 版 PyTorch 但显卡驱动过旧升级显卡驱动或先用--devicecpu按上述步骤操作后正常网络环境下从开始安装到打开界面的预期耗时约为 10–20 分钟首次包含模型下载。四、场景延伸与资源导航批量处理命令行消除整批图片不需要 Web 界面时可直接批处理。准备两个目录--image指向原图文件夹--mask指向对应的遮罩文件夹白色区域为待消除区域。若--mask指向单个文件则同一遮罩应用到所有图片。iopaint run --modellama --devicecpu --imageimages --maskmasks --outputout受限网络与二次使用⚠️ 镜像源建议只配 1–2 个稳定源过多反而导致解析混乱。仓库内的 win_setup_cn.bat 预置了清华源与腾讯云源两条镜像可作为镜像配置的参考模板。模型只下载一次第二次启动iopaint start直接走本地缓存耗时降至数十秒。需要固定模型位置时加--model-dir多台机器部署时可先把该目录整体拷贝过去。如需使用仓库内脚本先克隆仓库git clone https://gitcode.com/GitHub_Trending/io/IOPaint。资源导航项目总览与命令入口README.mdWindows 一键安装脚本说明scripts/README.md启动与更新脚本win_start.bat、win_update.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），仅供参考