IOPaint

环境要求

• 已安装 Python 与 pip3（README 用 pip3 安装）
• 支持 CPU、GPU 及 Apple Silicon 三种运行方式
• 首次启动需联网自动下载模型，请留出磁盘空间与等待时间
• 如需 GPU 加速，需先安装对应 CUDA 或 ROCm 版本的 PyTorch

安装与启动步骤

1. 1安装 GPU 版 PyTorch

   仅需 GPU 加速时执行，CUDA 与 ROCm 两条命令二选一，CPU 用户可跳过本步。

   pip3 install torch==2.1.2 torchvision==0.16.2 --index-url https://download.pytorch.org/whl/cu118

   复制

2. 2安装 IOPaint

   用 pip3 从 PyPI 安装 iopaint 包，建议在虚拟环境中执行以免污染全局环境。

   pip3 install iopaint

   复制

3. 3启动服务

   使用 lama 模型在 CPU 上启动，监听 8080 端口；换 GPU 可改 --device 参数。

   iopaint start --model=lama --device=cpu --port=8080

   复制

4. 4浏览器访问界面

   在浏览器打开本地地址即可使用 Web 修图界面，所有模型会在启动时自动下载。

   http://localhost:8080

   复制

关键配置

如何确认成功

终端启动无报错，浏览器访问 http://localhost:8080 能正常打开 IOPaint 修图界面即成功。

常见问题

注意事项

• CUDA 与 ROCm 两条 PyTorch 安装命令按硬件二选一，不要同时执行。
• 所有模型在启动时自动下载，首次启动较慢且需要稳定网络。
• 项目完全开源可自托管，支持 CPU、GPU 与 Apple Silicon。
• 更多安装与模型用法见官网 https://www.iopaint.com。