20 分钟装好 IOPaint：CPU 就能跑的免费 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 是一款免费开源的 AI 图像消除工具，能把照片里的路人、杂物、水印直接擦掉。真正卡住你的只有两件事：Python 版本和模型自动下载，这篇全帮你排掉。

装之前 1 分钟对完这 4 件事

不用敲命令，肉眼过一遍就行：

1. Python 版本 → 终端敲python -V，输出是 3.10.x 才算过 → 不是 3.10 就先装一个 3.10（IOPaint 依赖的 PyTorch 预编译包在 3.10 上最稳，版本不对后面装包会连环报错）
2. 磁盘空间 → 目标盘剩余大于 10GB → 不够就换个盘（IOPaint 加 PyTorch 加模型缓存，吃地方）
3. 网络 → 能访问 pypi.org，或者接受用国内镜像源 → 连不上就提前备好镜像（后面装包全靠它，走默认源经常半天没反应）
4. 端口 → 8080 没被别的程序占着 → 被占就计划好换 8081（Web 服务默认开在 8080）

环境搭建：4 条命令敲完就能装

确认版本。先敲一条命令看版本：

python -V

看到Python 3.10.x就说明这步成了；如果显示 3.8、3.11 之类，先按上面对齐再往下走。

建沙盒（虚拟环境）。相当于给项目单独划一块区域，装的包只在这块里生效，不污染系统：

python -m venv venv venv\Scripts\activate

命令行开头出现(venv)前缀，说明沙盒激活成功。⚠️ Mac 用户注意：激活命令是source venv/bin/activate。

切镜像源。把 pip 的下载源切到清华镜像，后面装包快很多：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

这条命令没有输出就是成了。

装包。IOPaint 本身一条命令装完，依赖全带上：

pip install -U iopaint

看到一长串Successfully installed ...往下滚是正常的，耐心等它结束。想核对依赖清单，仓库里的 requirements.txt 就是完整列表。

跑起来：1 条命令验证 AI 消除真的能干

在还激活着(venv)的窗口里敲：

iopaint start --model=lama --device=cpu --port=8080

这条命令做的事：用 CPU 加载 lama 这个轻量级修复模型（专门负责擦除，不吃显卡），把 Web 服务开在 8080 端口。🎯 成功标志：第一次跑会先在后台下载模型，终端刷进度条时别关窗口；等下载走完、不再滚动，浏览器打开http://localhost:8080能看到上传图片和涂抹掩码的界面，就算起来了。

常用参数不用背，就这四个：

其他参数默认值就能用，先别折腾。

卡住了？按顺序查这 3 处

• 依赖装不上，报错刷屏 → 大概率是网络问题 → 重新切一次镜像源再装：pip install -U iopaint，还不行就检查python -V是不是 3.10
• 端口被占，终端提示address already in use→ 8080 被别的程序占着 → 启动命令把--port=8080改成--port=8081
• 模型下载失败，进度条卡死或断流 → 模型托管在海外，网络抖动 → 别关窗口，直接重跑同一条iopaint start命令续传，多数情况第二次能过

以上都试过还不行，去项目 Issue 搜一下，九成有人踩过。

到这里 IOPaint 就跑通了：浏览器里打开图片，涂抹要消除的区域，点生成，图就干净了。想换模型或调参数，看项目 README 的 Advanced 部分即可。

【免费下载链接】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