IOPaint Windows 安装指南：3 个阶段在本地跑通 AI 抠物修复-二趣网

IOPaint Windows 安装指南：3 个阶段在本地跑通 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/IOPaint

IOPaint（前身 Lama Cleaner）是一个开源的 AI 修图工具，在图上涂好遮罩后，可以擦除不想要的物体、水印和路人，也可以用扩散模型替换画面内容。Windows 下官方脚本常卡在 PyTorch 大文件下载这一步，本文按拿脚本、配环境、跑起来 3 个阶段完成全部操作，通常 30 分钟内可以结束。

成果预览

装好后，浏览器打开 127.0.0.1:8080 就是一个网页版画板：上传照片，把不想留的人、水印、杂物涂黑，点开始，默认的 LaMa 模型会把那块区域补得自然。后续换用 Stable Diffusion 系列模型，还能替换物体、往图里写字。下面这两张就是同一张照片擦除多余物体前后的效果。

动手前 1 分钟环境自检

系统：64 位 Windows 10 及以上，脚本内部走 Conda 环境，不要指望和系统里已有的 Python 混用
磁盘：预留至少 10GB 空闲空间；打算加载 Stable Diffusion 系列模型的话，建议留到 20GB
网络：能正常访问国内镜像即可；首次启动还要下载模型文件，尽量保持连接稳定

核心流程：三个阶段

阶段一：拿到脚本和目录

做什么：把仓库克隆到一个不含中文和空格的路径，国内现成的安装与启动脚本都放在 scripts/user_scripts/ 里，认准带_cn后缀的两个 bat 文件。

git clone https://gitcode.com/GitHub_Trending/io/IOPaint cd IOPaint

成功标志：目录里能看到main.py和scripts文件夹。

阶段二：配环境装依赖

做什么：先把 pip 指到国内镜像，再按 torch、iopaint 的顺序装。官方脚本 win_setup_cn.bat 已包含这些步骤，若它卡住或你只想手动来，可以执行下面这条：

:: 先把 pip 指到国内镜像 pip config set global.extra-index-url "https://pypi.tuna.tsinghua.edu.cn/simple https://mirrors.cloud.tencent.com/pypi/simple" pip install torch==2.1.2 torchvision==0.16.2 --extra-index-url https://download.pytorch.org/whl/cu118 pip install -U iopaint

成功标志：输出以 Successfully installed 结尾，没有红色报错行。

阶段三：启动服务

做什么：把模型下载源切到 Hugging Face 国内镜像，再启动 CPU 版 LaMa。这正是官方 win_start_cn.bat 做的事：

set HF_ENDPOINT=https://hf-mirror.com iopaint start --model=lama --device=cpu

成功标志：控制台打印出服务地址，默认是 http://127.0.0.1:8080；首次启动会把模型拉到本地缓存，之后就不用再下了。

确认装成功的 3 个信号，外加 3 个高频问题

先对照这三条，都满足才算装完：

浏览器打开 http://127.0.0.1:8080 出现带编辑区的界面
上传一张测试图涂遮罩，能生成结果，控制台没有报错
控制台不再反复刷下载失败的提示

问：pip 在大文件上半天不动？答：大概率是镜像没生效。重跑一遍pip config set那条命令，或确认自己执行的是_cn版脚本。

问：首次启动要等多久？答：LaMa 模型几百 MB，稳定网络下通常几分钟到十几分钟；扩散模型几个 GB 起，按网络条件估。

问：重装会不会把所有包重新下一遍？答：pip 默认缓存已下载的包，第二次安装大多直接命中本地缓存，快很多；模型文件同理，下过一次就不再重复拉取。

参数更多、想换 GPU 或改端口时，先看 README.md 和对应启动脚本里的注释。接下来去打开那个页面，涂一个遮罩，把你相册里最碍眼的那个水印擦掉试试。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析