ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Windows安装IOPaint:环境自查到成功启动的完整避坑指南

Windows安装IOPaint:环境自查到成功启动的完整避坑指南 Windows安装IOPaint环境自查到成功启动的完整避坑指南【免费下载链接】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原 Lama Cleaner是一款开源AI修图工具核心功能是用SOTA模型移除图片中多余的物体、人物、水印与文字并支持基于Stable Diffusion的内容改写。本文面向Windows新手按时间线带你走通IOPaint安装的完整流程先做环境自查再换镜像加速安装最后完成首次启动验证。文中同时覆盖IOPaint下载慢、IOPaint Python版本冲突、IOPaint安装失败等高频卡点跟着步骤走即可在自己电脑上跑起来。动手之前先花30秒自查环境安装IOPaint时最常卡的四个位置本质都是环境没对齐海外源下载慢PyTorch相关依赖超过2GB默认海外源下载慢、易中断这是IOPaint下载慢反馈的主要原因第二节会用镜像解决。Python版本不匹配官方支持Python 3.8-3.10。更高版本与项目锁定的依赖包见 requirements.txt存在不兼容过低版本则缺wheel支持所以版本必须落在区间内。命令行不熟整个安装只需要复制粘贴三条命令下文全部给出。显卡/内存不足无NVIDIA显卡也能装只是降级CPU模式、出图变慢。IOPaint处理的效果大致如下——圈选多余元素后一键移除这也是我们折腾安装的目标Python版本一行自查打开命令提示符开始菜单搜索 cmd执行python --version输出3.8-3.10 → 通过直接进下一节。输出其他版本或提示不是内部命令 → 先安装3.8-3.10任意版本安装时勾选Add to PATH。系统里装了多个Python → 用py -3.10这样的方式显式指定版本避免装到错误的解释器上。内存与显卡检查按CtrlShiftEsc打开任务管理器切到性能页物理内存建议≥8GB低于此值CPU模式会比较吃力。在命令提示符执行nvidia-smi能打印显卡信息说明NVIDIA驱动正常可走CUDA加速提示不是内部命令则按无显卡处理走CPU模式即可不影响装完。安装过程先切镜像源再跑三条安装命令官方已内置面向国内用户的安装脚本 win_setup_cn.bat其中就是清华腾讯双镜像的配置思路。手动安装时照抄这套配置即可。IOPaint镜像源切换命令pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple pip config set global.extra-index-url https://pypi.tuna.tsinghua.edu.cn/simple https://mirrors.cloud.tencent.com/pypi/simple主源用清华extra里再挂腾讯做冗余阿里云https://mirrors.aliyun.com/pypi/simple、上交等任一国内镜像都能替代效果相近。该配置只写一次之后所有pip install自动走镜像。PyTorch的CUDA版wheel不在PyPI上官方脚本用的是--extra-index-url https://download.pytorch.org/whl/cu118指向官方CUDA 11.8 wheel源国内网络慢的话可先把wheel文件手动下载好再本地安装细节不必纠结能装上即可。本地缓存目录设置pip默认把下过的包装在用户目录缓存里重复安装可直接复用、无需重下。若C盘空间紧张在系统属性→环境变量里新增PIP_CACHE_DIR指向其他盘建议预留20GB以上视依赖体量而定即可把仓库搬到空间充足的磁盘。安装与启动三连命令镜像配好后依次执行pip install torch2.1.2 torchvision0.16.2 --extra-index-url https://download.pytorch.org/whl/cu118 pip install -U iopaint iopaint start前两行的版本号与官方Windows脚本完全一致cu118表示CUDA 11.8构建无NVIDIA显卡时去掉--extra-index-url参数装默认CPU版torch即可。iopaint start即启动入口服务默认监听8080端口可用--port改。启动验证等模型下完按标准确认通过⚠️ 第一次启动时IOPaint会下载模型权重体量在几GB量级耗时视网络而定通常从十几分钟到一小时。终端会打印下载进度此时不要关窗口。模型托管在HuggingFace国内网络下建议设置环境变量HF_ENDPOINThttps://hf-mirror.com官方启动脚本已内置该设置再执行iopaint start。通过标准只有一个终端显示服务已启动浏览器打开127.0.0.1:8080能看到图片编辑界面。能进界面即算安装成功能否用AI功能则取决于模型是否下载完成。打开界面后试着对一张图圈选去除某个元素作为功能上的二次确认。出错怎么办五个高频报错速查安装失败大多逃不出下面五类对号入座处理ModuleNotFoundError / 依赖版本冲突torch、diffusers相关报错最多→ 先确认python --version是否落在3.8-3.10锁定版本要求以 requirements.txt 为准不要手动混装不同大版本。pip下载超时、连接被重置→ 不重装重跑同一条命令让pip续传仍慢就换一家镜像清华→腾讯→阿里。磁盘空间不足→ 把PIP_CACHE_DIR指到其他盘并用pip cache purge清掉旧缓存。提示无CUDA / 检测不到GPU→ 这是降级信号不是故障改装CPU版torch即可正常运行只是推理慢无需折腾驱动。端口被占用 / 打不开页面→ 看终端实际输出的端口号默认8080冲突时加--port 8081换端口再打开浏览器。收尾自查清单与进阶路径进阶两句话带过需要离线环境时先在有网机器上跑完一遍安装让pip缓存与模型权重落满本地再把缓存目录与安装目录整体拷贝到离线机器无需联网多机批量部署同理——基准机装好后压缩分发目标机解压即可用。离开前过一遍这份清单python --version输出3.8-3.10内存≥8GB显卡情况已确认无卡CPU模式pip已配置国内镜像源torchcu118或CPU版安装成功iopaint start显示启动成功浏览器可打开页面 若清单全过仍卡住把终端完整报错文本带到项目讨论区提问附上Python版本与显卡型号基本能得到明确答复。祝一次装通。【免费下载链接】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),仅供参考
返回列表