企业官网建设流程全解析

如何三步在 Windows 上装好 IOPaint：15 分钟跑通 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

双击安装脚本，进度条却在 99% 附近寸步不前，关掉重开还是老样子——这是很多 Windows 用户的共同记忆。IOPaint 是一款 AI 修图工具，能擦除照片里多余的物体、人物、文字和水印。本文带你按三步完成 IOPaint 安装，全程不用手写配置。

问题定位：你卡在哪一步？

• 下载龟速：默认脚本从国外服务器取包，国内网络不稳定，几百兆的包要等上大半天。
• 版本冲突：系统里已有的 Python 和项目依赖对不上，装完弹出满屏英文报错。
• 配置门槛高：HF_ENDPOINT 这类环境变量（系统级的全局配置）需要手动填地址，填错就白等。

动手改：按顺序走完这三步

3.1 克隆仓库到本地

这一步相当于先把"食材"从仓库拉到自家厨房，后面的安装脚本就在本地跑。

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

⚠️ 若提示"git 不是内部命令"，先安装 Git 再执行，否则后两步无法开始。

3.2 运行中文安装脚本，完成国内加速

这一步把包下载渠道从海外仓改成国内镜像，是整个 IOPaint 安装教程里提速的关键。

打开scripts/user_scripts/文件夹，双击win_setup_cn.bat。该脚本已内置清华 pip 镜像（pip 下载加速源），静等安装完成即可。

⚠️ 下载 PyTorch 大包时窗口会长时间无输出，别当卡死关掉它，同时确保 C 盘剩余空间大于 10GB。

3.3 启动服务，让模型走国内镜像

装完相当于"通电"，这一步让模型文件的下载也接上国内通道。

双击scripts/user_scripts/win_start_cn.bat。它已把 HF_ENDPOINT 环境变量指向国内模型镜像，首次加载模型不会再慢如蜗牛。

⚠️ 若窗口一闪而过，多半是 8080 端口被别的程序占用，关闭占用程序后重试。

验证 & 第一次跑通 IOPaint

最小成功标准：命令行出现Running on local URL: http://127.0.0.1:8080字样，即代表安装成功。

Quick Start：

1. 浏览器打开 http://127.0.0.1:8080
2. 选择一张照片，用画笔刷选要去除的物体，点击运行

翻车自救清单

• 进度条长期不动→ 下载源仍走海外 → 确认你运行的是中文脚本win_setup_cn.bat而非英文版
• Python version 相关报错→ 系统 Python 与依赖不匹配 → 脚本会自建虚拟环境，直接重跑安装脚本，别去改系统 Python
• Address already in use→ 8080 端口被占用 → 用命令行参数--port 8081换个端口启动
• 模型下载 404 或中断→ 首次下载未完成 → 重新双击win_start_cn.bat，断点续传即可

到这里，你的 IOPaint 已经可以开工了。

• README.md
• scripts/README.md
• web_app/README.md

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