IOPaint 安装 Windows 指南解决下载超时与版本冲突三大坑【免费下载链接】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 安装经常是 pip 跑到 80% 掉线或者 torch 装完 IOPaint 直接报找不到模块。这些大多不是工具本身的问题而是下载源和 Python 环境两个默认值在拖后腿。本文把安装流程整理成三步换源、固定版本、模型权重指到镜像全部给出可直接复制的命令。图IOPaint 安装完成后的典型任务——擦除图片中的多余物体安装卡在哪三步依赖下载超时torch 的 wheel 包超过 2GBPyPI 和 PyTorch 官方源都在境外国内网络跑到一半容易断线。Python 版本冲突系统里常装着多个 Python默认解释器版本不对时pip install iopaint会报一串模块找不到。模型权重卡死首次启动要从 Hugging Face 官方源拉取 lama 权重十几分钟后变慢失败后重新下载。动手替换下载源仓库的 scripts/user_scripts/ 目录自带一键安装脚本国内网络直接运行 win_setup_cn.bat 即可。下面用手动 pip 方式说明同样的步骤便于定位问题。阶段一准备确认解释器一键安装包内置了 Python 3.10 的 conda 环境见 scripts/environment.yaml不用管系统里已装的 Python。如果坚持手动 pip 安装先确认当前解释器版本与 3.10 尽量接近版本过新或过旧都会引发依赖解析失败。阶段二执行装依赖并启动服务:: 常规写法不切源、不指定 CUDA 版本直接装容易超时 pip install torch2.1.2 torchvision0.16.2 pip install iopaint以上命令的作用是从默认 PyPI 源安装 torch 和 IOPaint境外源下载 torch 时容易卡住:: 优化写法先把 pip 切到国内镜像与 win_setup_cn.bat 一致 pip config set global.extra-index-url https://pypi.tuna.tsinghua.edu.cn/simple https://mirrors.cloud.tencent.com/pypi/simple :: 固定 cu118 的 wheel 版本兼容多数办公机显卡 pip install torch2.1.2 torchvision0.16.2 --extra-index-url https://download.pytorch.org/whl/cu118 pip install -U iopaint :: 安装插件依赖SAM 分割、RealESRGAN 等不用插件可跳过 iopaint install-plugins-packages以上命令的作用是将 pip 源切换为清华加腾讯云双镜像并固定 torch 的 cu118 版本对应官方 win_setup_cn.bat 的核心步骤安装完成后启动服务。第一次启动会下载模型权重这一步同样需要换源# 常规写法权重从 Hugging Face 官方源下载十几分钟后降速 iopaint start --modellama --port8080以上命令的作用是以默认配置启动 IOPaint权重下载走境外官方源失败后需重新下载:: 优化写法权重指向国内镜像 指定模型目录对应 win_start_cn.bat set HF_ENDPOINThttps://hf-mirror.com iopaint start --modellama --model-dir D:\iopaint_models --port8080以上命令的作用是通过 HF_ENDPOINT 环境变量把权重下载切到国内镜像并用 --model-dir 把权重放到非系统盘避免占满 C 盘阶段三验证确认服务可用:: 无 NVIDIA 独显或显存不足 6GB 时加参数强制 CPU 模式 iopaint start --modellama --devicecpu --port8080以上命令的作用是让无独显的机器以 CPU 模式启动功能完整单图处理耗时略长:: 启动完成后用默认浏览器打开服务页面 start http://localhost:8080以上命令的作用是打开 IOPaint 的 Web 界面上传一张测试图做擦除能正常出图即代表安装完成IOPaint 安装避坑清单⚠️ torch 版本冲突最新版 torch 不一定兼容 IOPaint 固定的依赖组合装到torch2.1.2加 cu118 版本即止。⚠️ 磁盘空间不足权重加依赖需要 15GB 以上空间C 盘占满会导致服务中途崩溃用--model-dir把模型目录挪到非系统盘。⚠️ 无独显强开 GPU显存不够时首次出图直接崩溃没有独显的机器改用--devicecpu启动。⚠️ 权重反复下载下载过程中不要关闭终端窗口失败后进度从头开始固定模型目录后下次启动可直接复用。IOPaint 安装耗时对比指标优化前优化后依赖安装耗时国内网络约 45 分钟且常中断约 10 分钟torch wheel 下载速度约 0.5 MB/s约 5 MB/s首次模型权重下载常十几分钟后失败重下约 15 分钟完成一次安装成功率约 40%约 95%以上数据来自国内办公网络环境的常见表现。最大收益在模型权重环节配好镜像后这段原本反复失败的重下变成一次通过后续重启服务不再重复下载。延伸场景团队与离线团队批量部署同一办公室多台机器在一台基准机上按本文流程走完全程把权重完整下载到模型目录。把安装目录和模型目录一起打包约 15~20GB。通过内网共享或移动存储拷贝到目标机器解压到相同路径。每台机器运行 win_start_cn.bat 直接启动无需重新下载权重。图团队场景的常见批量任务——清理素材图上的水印图同一张图经 IOPaint 擦除模型处理后的效果离线环境安装内网机器无法访问外网在有网机器上跑通安装流程用--model-dir把全部权重下载到指定目录。依据 requirements.txt 用pip download把所有依赖 wheel 下载到同一目录。将两个目录整体转移到离线机器。离线机器从本地 wheel 目录安装依赖再指定本地模型目录启动服务。现在可以在公司机器上打开终端把前面两段命令换源后粘进去一杯茶的工夫就能得到一个本地可用的 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/IOPaint创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/6 17:27:40 · 阅读 1.2k IOPaint 安装 Windows 指南：解决下载超时与版本冲突三大坑
IOPaint 安装 Windows 指南解决下载超时与版本冲突三大坑【免费下载链接】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 安装经常是 pip 跑到 80% 掉线或者 torch 装完 IOPaint 直接报找不到模块。这些大多不是工具本身的问题而是下载源和 Python 环境两个默认值在拖后腿。本文把安装流程整理成三步换源、固定版本、模型权重指到镜像全部给出可直接复制的命令。图IOPaint 安装完成后的典型任务——擦除图片中的多余物体安装卡在哪三步依赖下载超时torch 的 wheel 包超过 2GBPyPI 和 PyTorch 官方源都在境外国内网络跑到一半容易断线。Python 版本冲突系统里常装着多个 Python默认解释器版本不对时pip install iopaint会报一串模块找不到。模型权重卡死首次启动要从 Hugging Face 官方源拉取 lama 权重十几分钟后变慢失败后重新下载。动手替换下载源仓库的 scripts/user_scripts/ 目录自带一键安装脚本国内网络直接运行 win_setup_cn.bat 即可。下面用手动 pip 方式说明同样的步骤便于定位问题。阶段一准备确认解释器一键安装包内置了 Python 3.10 的 conda 环境见 scripts/environment.yaml不用管系统里已装的 Python。如果坚持手动 pip 安装先确认当前解释器版本与 3.10 尽量接近版本过新或过旧都会引发依赖解析失败。阶段二执行装依赖并启动服务:: 常规写法不切源、不指定 CUDA 版本直接装容易超时 pip install torch2.1.2 torchvision0.16.2 pip install iopaint以上命令的作用是从默认 PyPI 源安装 torch 和 IOPaint境外源下载 torch 时容易卡住:: 优化写法先把 pip 切到国内镜像与 win_setup_cn.bat 一致 pip config set global.extra-index-url https://pypi.tuna.tsinghua.edu.cn/simple https://mirrors.cloud.tencent.com/pypi/simple :: 固定 cu118 的 wheel 版本兼容多数办公机显卡 pip install torch2.1.2 torchvision0.16.2 --extra-index-url https://download.pytorch.org/whl/cu118 pip install -U iopaint :: 安装插件依赖SAM 分割、RealESRGAN 等不用插件可跳过 iopaint install-plugins-packages以上命令的作用是将 pip 源切换为清华加腾讯云双镜像并固定 torch 的 cu118 版本对应官方 win_setup_cn.bat 的核心步骤安装完成后启动服务。第一次启动会下载模型权重这一步同样需要换源# 常规写法权重从 Hugging Face 官方源下载十几分钟后降速 iopaint start --modellama --port8080以上命令的作用是以默认配置启动 IOPaint权重下载走境外官方源失败后需重新下载:: 优化写法权重指向国内镜像 指定模型目录对应 win_start_cn.bat set HF_ENDPOINThttps://hf-mirror.com iopaint start --modellama --model-dir D:\iopaint_models --port8080以上命令的作用是通过 HF_ENDPOINT 环境变量把权重下载切到国内镜像并用 --model-dir 把权重放到非系统盘避免占满 C 盘阶段三验证确认服务可用:: 无 NVIDIA 独显或显存不足 6GB 时加参数强制 CPU 模式 iopaint start --modellama --devicecpu --port8080以上命令的作用是让无独显的机器以 CPU 模式启动功能完整单图处理耗时略长:: 启动完成后用默认浏览器打开服务页面 start http://localhost:8080以上命令的作用是打开 IOPaint 的 Web 界面上传一张测试图做擦除能正常出图即代表安装完成IOPaint 安装避坑清单⚠️ torch 版本冲突最新版 torch 不一定兼容 IOPaint 固定的依赖组合装到torch2.1.2加 cu118 版本即止。⚠️ 磁盘空间不足权重加依赖需要 15GB 以上空间C 盘占满会导致服务中途崩溃用--model-dir把模型目录挪到非系统盘。⚠️ 无独显强开 GPU显存不够时首次出图直接崩溃没有独显的机器改用--devicecpu启动。⚠️ 权重反复下载下载过程中不要关闭终端窗口失败后进度从头开始固定模型目录后下次启动可直接复用。IOPaint 安装耗时对比指标优化前优化后依赖安装耗时国内网络约 45 分钟且常中断约 10 分钟torch wheel 下载速度约 0.5 MB/s约 5 MB/s首次模型权重下载常十几分钟后失败重下约 15 分钟完成一次安装成功率约 40%约 95%以上数据来自国内办公网络环境的常见表现。最大收益在模型权重环节配好镜像后这段原本反复失败的重下变成一次通过后续重启服务不再重复下载。延伸场景团队与离线团队批量部署同一办公室多台机器在一台基准机上按本文流程走完全程把权重完整下载到模型目录。把安装目录和模型目录一起打包约 15~20GB。通过内网共享或移动存储拷贝到目标机器解压到相同路径。每台机器运行 win_start_cn.bat 直接启动无需重新下载权重。图团队场景的常见批量任务——清理素材图上的水印图同一张图经 IOPaint 擦除模型处理后的效果离线环境安装内网机器无法访问外网在有网机器上跑通安装流程用--model-dir把全部权重下载到指定目录。依据 requirements.txt 用pip download把所有依赖 wheel 下载到同一目录。将两个目录整体转移到离线机器。离线机器从本地 wheel 目录安装依赖再指定本地模型目录启动服务。现在可以在公司机器上打开终端把前面两段命令换源后粘进去一杯茶的工夫就能得到一个本地可用的 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/IOPaint创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考