ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

15 分钟装好 IOPaint:Windows 一键安装脚本与卡点排查

2026/9/6 16:56:23 拓冰建站 浏览量
15 分钟装好 IOPaint:Windows 一键安装脚本与卡点排查 15 分钟装好 IOPaintWindows 一键安装脚本与卡点排查【免费下载链接】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本文帮你在 Windows 上完成 IOPaint 安装与启动预计 15 分钟。IOPaint 是一款免费的 AI 修图工具能擦除照片里的杂物、人物、水印和文字。适合个人电脑首次部署跟着脚本走即可。一、开工前30 秒环境自检先花半分钟把下表过一遍每项都能快速确认检查项要求怎么快速确认操作系统Windows 10 / 11系统自带即可磁盘空间安装目录所在盘剩余 10GB 以上查看该盘属性或用dir C:\看最下方的可用字节网络能正常访问国内网站浏览器打开清华官网试试稳定即可NVIDIA 显卡可选有独显可加速管理员运行nvidia-smi能显示显卡信息即可Python 版本无需操心脚本自带 conda 环境Python 的独立运行小空间装好就能用⚠️ 特别提醒IOPaint 安装脚本会自己带一套 conda 环境不需要你提前装 Python。参考文章里必须 Python 3.10.x的说法只适用于完全手动安装的场景一键安装这条路不会碰到版本冲突。涉及的两个关键文件都在仓库的scripts/user_scripts/目录下安装脚本win_setup_cn.bat和启动脚本win_start_cn.bat。二、主线安装跟着走别跳步阶段 1获取 IOPaint 项目文件阶段目标把源码拿到本地磁盘。操作步骤打开命令提示符cmd在 C 盘建一个目录如D:\ai-tools。执行git clone https://gitcode.com/GitHub_Trending/io/IOPaint等它拉完。预期结果出现IOPaint文件夹里面有scripts、iopaint等子目录。 如果电脑没装 git可以到 gitcode.com 的仓库页面下载 zip 压缩包解压到同一位置效果一样。文件就位后剩下的交给脚本。阶段 2运行 IOPaint Windows 一键安装脚本阶段目标一次装好全部依赖含 PyTorch 和 IOPaint 本体。操作步骤进入IOPaint\scripts\user_scripts\目录。双击win_setup_cn.bat等窗口滚动结束。预期结果窗口最后停在PAUSE字样按任意键即可。全程约 515 分钟主要耗时在 PyTorch 上。这个脚本帮你自动做了三件事激活自带 conda 环境把 pip 镜像包下载源设成清华和腾讯云源安装 PyTorch 2.1.2CUDA 11.8 版、IOPaint 本体和插件依赖。全程不用手动改任何环境变量系统运行时的配置参数。⚠️ 窗口出现PAUSE后先别关下一步要接着用。装完依赖还不能直接画图还差一步启动服务。阶段 3启动 IOPaint 服务并打开网页端阶段目标把编辑界面跑起来。操作步骤在IOPaint\scripts\目录下双击win_start_cn.bat。看到日志提示服务就绪默认端口 8080后用浏览器打开 http://localhost:8080 。预期结果浏览器里出现 IOPaint 编辑界面能选模型、传图片。启动脚本会自动设置HF_ENDPOINThttps://hf-mirror.com也就是把 AI 模型文件的下载指向国内镜像不用你手动配置。首次启动会自动下载 LaMa 模型擦除用的基础模型需要再等 510 分钟。图IOPaint Windows 一键安装完成后浏览器里打开的本地编辑界面示例图三、装完了花 20 秒验证一下打开 http://localhost:8080 传一张带水印或杂物的照片用笔刷涂掉不需要的区域点 Run。几秒后涂抹区域被自然填补就说明装好了 ✅一个假成功的坑端口被别的程序占用时打开 8080 看到的可能是别的东西。页面不对就先改端口如 8081再启动别急着怀疑安装失败。四、卡住了对照这张表报错关键词原因一句话解决方法一句话pip / downloading 长时间不动走的是国外源网速慢确认安装脚本用的是清华/腾讯镜像源删目录后重装localhost:8080 打不开端口被别的程序占用启动时改用 8081、8082 等其他端口Access is denied / 权限错误没有管理员权限详见下方补充模型下载反复失败网络波动模型文件没拉完重跑win_start_cn.bat它会接着下日志显示使用 CPU 而非 GPUPyTorch 的 CUDA 版没装上详见下方补充权限问题需要两步右键脚本选以管理员身份运行如果还不行就重启一次电脑再试。GPU 没被使用通常不是显卡问题而是装成了 CPU 版 PyTorch——用管理员 cmd 运行nvidia-smi确认显卡正常后删掉整个安装目录重装一次即可。五、资源与下一步scripts/user_scripts/win_setup_cn.batWindows 一键安装脚本含国内镜像源配置。scripts/user_scripts/win_start_cn.bat启动脚本已内置模型下载国内镜像。scripts/README.mdWindows 安装器说明文档。assets/unwant_object_clean.jpgIOPaint 擦除杂物效果示例图可对照测试你的安装效果。装好就是能用。打开浏览器先用 LaMa 模型去个水印练练手后面想换更强的替换模型时再回来翻文档。【免费下载链接】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),仅供参考