如何安装和开始使用 IOPaint?

IOPaint 是一个免费、开源、可完全自托管的图像修复（inpainting）与扩展（outpainting）工具，由多种前沿 AI 模型驱动。要开始使用它，你需要按官网的 Install 安装指引在本地或服务器上完成部署，部署后即可选择不同模型执行擦除、局部修改、文字生成和画面扩展等操作。它适合希望自己掌控运行环境、不想依赖第三方在线服务的用户；如果你只需要偶尔处理一两张图片，自托管的前期部署成本需要先纳入考虑。

IOPaint 能做什么

根据官网介绍，IOPaint 支持以下几类图像编辑任务：

官网还提到，作者另开发了 macOS / iOS 应用 OptiClean 提供擦除功能；如果你只需要擦除且使用苹果设备，可以把它作为一个备选了解，但本文聚焦自托管的 IOPaint 本身。

安装前的准备

官网只提供了 Install 安装指引入口，具体命令与依赖以该页面为准。开始之前，你需要先确认几件事：

• 运行环境：IOPaint 可完全自托管，意味着你要有一台能运行它的机器——本地电脑或服务器均可。具体支持的系统与 Python 版本要求，请以 Install 页面说明为准。
• 硬件条件：不同 AI 模型对显存/内存的要求不同。官网未在首页列出具体参数，部署前建议在安装文档或模型说明中核对，避免选了大模型却跑不动。
• 网络：首次运行通常需要下载模型权重，需保证网络可访问模型下载源。
• 用途规划：先想清楚主要做擦除、替换还是扩展，这会影响你后续选择哪个模型。

安装与启动步骤

以下为通用流程，具体命令请对照官网 Install 页面执行：

1. 打开安装指引：访问 iopaint.com，找到 Install 入口，阅读其中的安装说明。
2. 准备环境：按文档要求安装运行环境（如 Python 及相关依赖）。输入是文档给出的安装命令，动作是在终端执行，预期结果是环境就绪、无报错。
3. 安装 IOPaint：执行文档提供的安装命令。预期结果是安装完成后可以在命令行调用 IOPaint。
4. 启动服务：按文档说明启动 IOPaint。预期结果是本地或服务器上出现可访问的 Web 界面地址。
5. 在界面中操作：打开界面后上传图片，选择模型，涂抹需要处理的区域，执行擦除、修复或扩展。

选择模型的基本思路

官网演示视频展示了不同模型的分工，可以按任务对应选择：

• 做擦除（去物体、去水印、去人物）：优先考虑 LaMa。
• 做局部替换或添加物体：可试 PowerPaint；需要“以图为例”的风格化替换时可了解 PaintByExample。
• 做画面扩展：使用 PowerPaint 的 outpainting 能力。
• 做文字生成：使用 AnyText。

模型的具体能力边界和参数，官网首页未展开，实际使用时以界面中可选模型和文档说明为准。

验证是否成功

部署完成后，用一个简单任务验证：上传一张带水印或多余物体的图片，选择 LaMa 涂抹该区域并执行擦除。如果区域被自然填补、画面无明显断裂，说明安装与模型加载均正常。若失败，优先检查模型是否下载完整、运行环境版本是否匹配文档要求。

常见卡点

• 模型下载失败或不完整：首次运行依赖模型权重，网络中断会导致加载报错，重新触发下载或手动检查模型目录。
• 显存/内存不足：换用更轻量的模型，或按文档调整运行参数。
• 命令与文档不一致：以官网 Install 页面为准，不要混用不同版本的安装说明。
• 误以为是在线服务：IOPaint 是自托管工具，没有“注册即用”的在线入口，所有处理都在你自己的环境中完成。

如果你希望快速上手且不介意部署成本，按上述流程走一遍即可；如果你更看重开箱即用，需要先评估自托管带来的环境维护工作是否值得。