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你刚双击安装脚本终端滚了 3 分钟停住吐出一行红字ERROR: Could not find a version that satisfies the requirement torch——问题多半不在工具而在环境没对齐。IOPaint 是一款开源 AI 修图工具圈选区域就能擦除或重绘照片里多余的人物、文字、水印也能用扩散模型替换画面内容。Windows 下按本文配置从空白环境到浏览器里修图页面亮起全程约 15–20 分钟实测一次跑通率可从约五成提到 95%估算。记住口诀三查两改一启动——查环境、改镜像、启动验证。环境摸底30秒确认这台机器能不能跑IOPaint安装前先做体检下面清单逐条过一遍Windows 10/11 64 位系统——32 位系统装不了 64 位的 PyTorch 轮子第一步就会报错可管理 Python 的 conda或 miniconda——官方环境文件锁定 scripts/environment.yaml 里的 Python 3.10版本错位会连环出现模块找不到至少 10GB 空闲磁盘——依赖约 2–3GB修图模型还要再占几个 GB能正常访问国内网络——访问不了镜像源下载会慢到几十 KB/s 并频繁断线NVIDIA 显卡及驱动可选——没有也能用 CPU 跑只是扩散类模型明显变慢30 秒自检打开终端依次执行下面三行确认版本、显卡、剩余空间:: 默认做法不检查直接 pip install iopaint卡住了再回头查 python --version :: 本文做法先跑三行自检心里有底再动手 python --version nvidia-smi powershell -command Get-PSDrive C | Select-Object Used,Free✅ 预期第一行输出 3.10.x 附近的 Python 版本若系统 Python 不是也别慌下一步 conda 会帮你建好有 N 卡则第二行列出型号与显存第三行确认剩余空间 ≥10GB。这里之所以先查 Python是因为后面所有依赖都是按 3.10 编译匹配的版本对齐了后面九成的神秘报错都不会发生——就像装修前先看户型图比敲了墙再补救省事得多。图 1IOPaint 的修图对象——这类图上冗余的文字圈选后擦除即可对应本节的工具能干什么配置实操四步在Windows上启动IOPaint修图服务步骤1克隆仓库并创建隔离的conda环境目的给 IOPaint 一个干净的 Python 3.10 运行环境避免污染系统 Python。:: 默认做法 pip install iopaint :: 本文做法 git clone https://gitcode.com/GitHub_Trending/io/IOPaint cd IOPaint conda env create -f scripts\environment.yaml conda activate lama-cleaner验证执行python --version输出 3.10.x 即成功。原理environment.yaml是官方锁定的环境清单照单创建等于直接抄作业独立 conda 环境像给装修队租了个独立工棚材料和工具互不干扰撤掉也不伤原房。步骤2配置pip镜像并安装CUDA版PyTorch目的让 2GB 多的 PyTorch 及其依赖从龟速通道切换到国内高速通道。:: 默认做法 pip install torch2.1.2 torchvision0.16.2 --extra-index-url https://download.pytorch.org/whl/cu118 :: 本文做法 pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple pip config set global.extra-index-url https://mirrors.cloud.tencent.com/pypi/simple pip install torch2.1.2 torchvision0.16.2 --extra-index-url https://download.pytorch.org/whl/cu118验证执行python -c import torch;print(torch.__version__, torch.cuda.is_available())输出2.1.2cu118 True为佳无 N 卡时输出False也属正常。原理清华、腾讯镜像负责普通依赖PyTorch 官方 cu118 轮子库只负责带 CUDA 的 torch 本体——两条路各走各的车道。这就像高速路网加了备用匝道主路拥堵时普通车自动换道而不影响运特殊货物的大货车。步骤3安装IOPaint本体与插件依赖目的装好修图主程序并把插件超分、抠图、人脸修复等依赖一次备齐避免启动时逐个报错。:: 默认做法 pip install -U iopaint :: 本文做法 pip install -U iopaint iopaint install-plugins-packages验证执行iopaint --help能看到start、run、list等子命令说明即安装成功。原理插件依赖多且杂官方提供了专门的安装入口一行命令全补齐。这里之所以多装一步是因为插件缺依赖属于入住后才发现没通水现场补装比开工前一次装好费时得多。步骤4配置模型下载源并启动修图服务目的模型权重托管在 HuggingFace国内直连不稳定换镜像端点后再启动服务。:: 默认做法 iopaint start --modellama --devicecpu --port8080 :: 本文做法 set HF_ENDPOINThttps://hf-mirror.com iopaint start --modellama --devicecpu --port8080验证浏览器打开http://localhost:8080页面能加载、能上传试图即 ✅终端首次启动会先打印环境信息并自动下载 lama 模型。原理HF_ENDPOINT只改快递取件点包裹模型文件本身没变有 N 卡可把--devicecpu改成--devicecuda。⚠️避坑提示模型默认缓存在C:\Users\你的用户名\.cache可用--model-dir或环境变量XDG_CACHE_HOME改到空间更足的盘建议预留 5GB 以上。图 2IOPaint 擦除多余物体的效果——启动服务后圈选物体即可得到这样的干净画面排障兜底IOPaint Windows安装高频问题对照处理报错iopaint 不是内部或外部命令现象iopaint 不是内部或外部命令也不是可运行的程序或批处理文件。根因当前 shell 没激活 conda 环境或把包装进了另一个 Python。解法执行conda activate lama-cleaner→ 再跑where iopaint确认路径在环境目录下 → 仍无输出就在环境内重跑pip install -U iopaint。报错Found no NVIDIA driver或CUDA不可用现象终端提示找不到 NVIDIA 驱动或torch.cuda.is_available()返回False。根因装成了 CPU 版 torch或显卡驱动过旧不支持 cu118。解法先用nvidia-smi看驱动是否正常 → 卸载后按步骤 2 重装 cu118 轮子 → 驱动实在太旧就先--devicecpu用起来升级驱动后再切 GPU。模型下载卡在0%或反复断连现象启动后下载 lama 模型进度条长时间不动或Connection reset后从头再来。根因未设HF_ENDPOINT时走了 HuggingFace 海外直连。解法按步骤 4 设置镜像端点后重启服务 → 已有下载进度的模型不会重下耐心等它续传。⚠️避坑提示模型下载中途别强关终端中断后已下分片可能作废等于白跑一趟。扩散模型崩溃、显存溢出或输出黑屏硬件不足类现象CUDA out of memory或出图整张纯黑、纯绿。根因显存低于模型需求扩散模型建议 6GB 起或显卡对半精度支持不佳。解法在启动参数上逐级追加先加--low-mem→ 再加--cpu-offload→ 仍黑屏加--no-half→ 都不行就--devicecpu慢速兜底。完整参数说明见 iopaint/cli.py。⚠️避坑提示动手前用任务管理器确认内存 ≥8GB扩散类模型显存 6GB 以上体验才完整低显存机器优先用 lama 等擦除模型。效果验证换完镜像到底快多少按本文流程与默认做法裸装、海外直连各走一遍的对比如下均为估算值网络按 500M 家宽测试指标默认做法本文做法变化依赖下载耗时约 45 分钟易断线约 10 分钟缩短约 78%首次启动到出图1 小时以上含重试约 20 分钟全程不断线一次跑通率约 50%约 95%少回头补装下载过程内存峰值占用约 1.2GB约 0.8GB系统更不卡两个最显著的变化值得点名耗时主要省在 PyTorch 轮子和模型两个大文件上镜像把单车道桥梁换成了多车道高速成功率提升则来自步骤 1 的 conda 版本对齐——环境对了后面基本不翻车。图 3IOPaint 水印擦除前后对比——配置完成后这类带水印的图圈选水印区域即可清理读者实测邀请跑完后按固定格式在评论区留下你的数据方便大家横向参考——[网络环境]-[硬件配置]-[总耗时]例如[500M家宽]-[RTX 3060 12G / 16G内存]-[12分钟]。进阶场景从单机修图到批量与团队使用整批图片批量处理修几百张图不必在网页里逐张点。准备两个文件夹原图目录和掩码目录掩码与原图同名或用一张掩码套所有图执行iopaint run --modellama --devicecpu --image原图目录 --mask掩码目录 --output输出目录加--concat可把原图、掩码、结果拼成对比图命令行用法与参数细节参考 iopaint/cli.py 中run命令的帮助文本。内网离线环境没有外网的机房、工厂也能用。在有网机器上按本文流程启动一次让模型完整下载到模型目录打包模型目录与 conda 环境或依赖清单拷贝到内网机器用--model-dir指向拷入的模型目录启动时加--local-files-only服务将只读本地、不再联网。团队多台电脑统一部署一台基准机跑通后把 conda 环境目录与模型缓存整体拷贝分发即可官方仓库 scripts/user_scripts/ 下提供了win_setup_cn.bat、win_start_cn.bat等现成批处理脚本正是镜像源 HuggingFace 镜像端点的组合可直接参考或复用。遇到本文没覆盖的问题欢迎到项目 issue 区提交维护者响应比较及时。收尾三查两改一启动剩下交给你回头看全程就一条线查环境 → 改 pip 镜像装 torch → 改模型源启动服务四步做完页面就亮了。四个配置步骤里哪一个对你帮助最大——是 conda 隔离还是两处镜像切换欢迎留言聊聊你踩过的坑有改进思路也欢迎提 issue 或直接参与项目讨论让下一个装 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/7 3:53:42 · 阅读 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你刚双击安装脚本终端滚了 3 分钟停住吐出一行红字ERROR: Could not find a version that satisfies the requirement torch——问题多半不在工具而在环境没对齐。IOPaint 是一款开源 AI 修图工具圈选区域就能擦除或重绘照片里多余的人物、文字、水印也能用扩散模型替换画面内容。Windows 下按本文配置从空白环境到浏览器里修图页面亮起全程约 15–20 分钟实测一次跑通率可从约五成提到 95%估算。记住口诀三查两改一启动——查环境、改镜像、启动验证。环境摸底30秒确认这台机器能不能跑IOPaint安装前先做体检下面清单逐条过一遍Windows 10/11 64 位系统——32 位系统装不了 64 位的 PyTorch 轮子第一步就会报错可管理 Python 的 conda或 miniconda——官方环境文件锁定 scripts/environment.yaml 里的 Python 3.10版本错位会连环出现模块找不到至少 10GB 空闲磁盘——依赖约 2–3GB修图模型还要再占几个 GB能正常访问国内网络——访问不了镜像源下载会慢到几十 KB/s 并频繁断线NVIDIA 显卡及驱动可选——没有也能用 CPU 跑只是扩散类模型明显变慢30 秒自检打开终端依次执行下面三行确认版本、显卡、剩余空间:: 默认做法不检查直接 pip install iopaint卡住了再回头查 python --version :: 本文做法先跑三行自检心里有底再动手 python --version nvidia-smi powershell -command Get-PSDrive C | Select-Object Used,Free✅ 预期第一行输出 3.10.x 附近的 Python 版本若系统 Python 不是也别慌下一步 conda 会帮你建好有 N 卡则第二行列出型号与显存第三行确认剩余空间 ≥10GB。这里之所以先查 Python是因为后面所有依赖都是按 3.10 编译匹配的版本对齐了后面九成的神秘报错都不会发生——就像装修前先看户型图比敲了墙再补救省事得多。图 1IOPaint 的修图对象——这类图上冗余的文字圈选后擦除即可对应本节的工具能干什么配置实操四步在Windows上启动IOPaint修图服务步骤1克隆仓库并创建隔离的conda环境目的给 IOPaint 一个干净的 Python 3.10 运行环境避免污染系统 Python。:: 默认做法 pip install iopaint :: 本文做法 git clone https://gitcode.com/GitHub_Trending/io/IOPaint cd IOPaint conda env create -f scripts\environment.yaml conda activate lama-cleaner验证执行python --version输出 3.10.x 即成功。原理environment.yaml是官方锁定的环境清单照单创建等于直接抄作业独立 conda 环境像给装修队租了个独立工棚材料和工具互不干扰撤掉也不伤原房。步骤2配置pip镜像并安装CUDA版PyTorch目的让 2GB 多的 PyTorch 及其依赖从龟速通道切换到国内高速通道。:: 默认做法 pip install torch2.1.2 torchvision0.16.2 --extra-index-url https://download.pytorch.org/whl/cu118 :: 本文做法 pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple pip config set global.extra-index-url https://mirrors.cloud.tencent.com/pypi/simple pip install torch2.1.2 torchvision0.16.2 --extra-index-url https://download.pytorch.org/whl/cu118验证执行python -c import torch;print(torch.__version__, torch.cuda.is_available())输出2.1.2cu118 True为佳无 N 卡时输出False也属正常。原理清华、腾讯镜像负责普通依赖PyTorch 官方 cu118 轮子库只负责带 CUDA 的 torch 本体——两条路各走各的车道。这就像高速路网加了备用匝道主路拥堵时普通车自动换道而不影响运特殊货物的大货车。步骤3安装IOPaint本体与插件依赖目的装好修图主程序并把插件超分、抠图、人脸修复等依赖一次备齐避免启动时逐个报错。:: 默认做法 pip install -U iopaint :: 本文做法 pip install -U iopaint iopaint install-plugins-packages验证执行iopaint --help能看到start、run、list等子命令说明即安装成功。原理插件依赖多且杂官方提供了专门的安装入口一行命令全补齐。这里之所以多装一步是因为插件缺依赖属于入住后才发现没通水现场补装比开工前一次装好费时得多。步骤4配置模型下载源并启动修图服务目的模型权重托管在 HuggingFace国内直连不稳定换镜像端点后再启动服务。:: 默认做法 iopaint start --modellama --devicecpu --port8080 :: 本文做法 set HF_ENDPOINThttps://hf-mirror.com iopaint start --modellama --devicecpu --port8080验证浏览器打开http://localhost:8080页面能加载、能上传试图即 ✅终端首次启动会先打印环境信息并自动下载 lama 模型。原理HF_ENDPOINT只改快递取件点包裹模型文件本身没变有 N 卡可把--devicecpu改成--devicecuda。⚠️避坑提示模型默认缓存在C:\Users\你的用户名\.cache可用--model-dir或环境变量XDG_CACHE_HOME改到空间更足的盘建议预留 5GB 以上。图 2IOPaint 擦除多余物体的效果——启动服务后圈选物体即可得到这样的干净画面排障兜底IOPaint Windows安装高频问题对照处理报错iopaint 不是内部或外部命令现象iopaint 不是内部或外部命令也不是可运行的程序或批处理文件。根因当前 shell 没激活 conda 环境或把包装进了另一个 Python。解法执行conda activate lama-cleaner→ 再跑where iopaint确认路径在环境目录下 → 仍无输出就在环境内重跑pip install -U iopaint。报错Found no NVIDIA driver或CUDA不可用现象终端提示找不到 NVIDIA 驱动或torch.cuda.is_available()返回False。根因装成了 CPU 版 torch或显卡驱动过旧不支持 cu118。解法先用nvidia-smi看驱动是否正常 → 卸载后按步骤 2 重装 cu118 轮子 → 驱动实在太旧就先--devicecpu用起来升级驱动后再切 GPU。模型下载卡在0%或反复断连现象启动后下载 lama 模型进度条长时间不动或Connection reset后从头再来。根因未设HF_ENDPOINT时走了 HuggingFace 海外直连。解法按步骤 4 设置镜像端点后重启服务 → 已有下载进度的模型不会重下耐心等它续传。⚠️避坑提示模型下载中途别强关终端中断后已下分片可能作废等于白跑一趟。扩散模型崩溃、显存溢出或输出黑屏硬件不足类现象CUDA out of memory或出图整张纯黑、纯绿。根因显存低于模型需求扩散模型建议 6GB 起或显卡对半精度支持不佳。解法在启动参数上逐级追加先加--low-mem→ 再加--cpu-offload→ 仍黑屏加--no-half→ 都不行就--devicecpu慢速兜底。完整参数说明见 iopaint/cli.py。⚠️避坑提示动手前用任务管理器确认内存 ≥8GB扩散类模型显存 6GB 以上体验才完整低显存机器优先用 lama 等擦除模型。效果验证换完镜像到底快多少按本文流程与默认做法裸装、海外直连各走一遍的对比如下均为估算值网络按 500M 家宽测试指标默认做法本文做法变化依赖下载耗时约 45 分钟易断线约 10 分钟缩短约 78%首次启动到出图1 小时以上含重试约 20 分钟全程不断线一次跑通率约 50%约 95%少回头补装下载过程内存峰值占用约 1.2GB约 0.8GB系统更不卡两个最显著的变化值得点名耗时主要省在 PyTorch 轮子和模型两个大文件上镜像把单车道桥梁换成了多车道高速成功率提升则来自步骤 1 的 conda 版本对齐——环境对了后面基本不翻车。图 3IOPaint 水印擦除前后对比——配置完成后这类带水印的图圈选水印区域即可清理读者实测邀请跑完后按固定格式在评论区留下你的数据方便大家横向参考——[网络环境]-[硬件配置]-[总耗时]例如[500M家宽]-[RTX 3060 12G / 16G内存]-[12分钟]。进阶场景从单机修图到批量与团队使用整批图片批量处理修几百张图不必在网页里逐张点。准备两个文件夹原图目录和掩码目录掩码与原图同名或用一张掩码套所有图执行iopaint run --modellama --devicecpu --image原图目录 --mask掩码目录 --output输出目录加--concat可把原图、掩码、结果拼成对比图命令行用法与参数细节参考 iopaint/cli.py 中run命令的帮助文本。内网离线环境没有外网的机房、工厂也能用。在有网机器上按本文流程启动一次让模型完整下载到模型目录打包模型目录与 conda 环境或依赖清单拷贝到内网机器用--model-dir指向拷入的模型目录启动时加--local-files-only服务将只读本地、不再联网。团队多台电脑统一部署一台基准机跑通后把 conda 环境目录与模型缓存整体拷贝分发即可官方仓库 scripts/user_scripts/ 下提供了win_setup_cn.bat、win_start_cn.bat等现成批处理脚本正是镜像源 HuggingFace 镜像端点的组合可直接参考或复用。遇到本文没覆盖的问题欢迎到项目 issue 区提交维护者响应比较及时。收尾三查两改一启动剩下交给你回头看全程就一条线查环境 → 改 pip 镜像装 torch → 改模型源启动服务四步做完页面就亮了。四个配置步骤里哪一个对你帮助最大——是 conda 隔离还是两处镜像切换欢迎留言聊聊你踩过的坑有改进思路也欢迎提 issue 或直接参与项目讨论让下一个装 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），仅供参考