IOpaint

字数

405 字

阅读

2 分钟

IOPaint 是一个强大的现代图像修复与编辑工具，提供交互式掩码绘制、AI 物体移除、背景替换以及多种增强功能。

主界面

启动方式

• 链接启动

http://127.0.0.1:8000/launcher?project=iopaint

• 命令启动

uv run cli.py install -n iopaint -p 8001 --start

• 原生启动

uv run main.py start --config ../webapp/extensions/iopaint/data/config.json

输出日志

Python 3.10.19
Using extensions/iopaint/.venv/scripts/python.exe
Checked 106 packages in 2ms
All installed packages are compatible
Audited 24 packages in 9ms
...

2025-12-23 23:29:23.020 | INFO     | iopaint.model_manager:init_model:47 - Loading model: lama
2025-12-23 23:29:23.020 | INFO     | iopaint.helper:load_jit_model:107 - Loading model from: D:\Program Files\CreatorBox\creatorbox\models\torch\hub\checkpoints\big-lama.pt
INFO:     Started server process [9448]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:8001 (Press CTRL+C to quit)

参数配置

webapp/extensions/iopaint/data/config.json

{
    "host": "0.0.0.0",
    "port": 8001,
    "inbrowser": false,
    "model": "lama",
    "no_half": false,
    "low_mem": false,
    "cpu_offload": false,
    "disable_nsfw_checker": false,
    "local_files_only": false,
    "cpu_textencoder": false,
    "device": "cpu",
    "input": null,
    "mask_dir": null,
    "output_dir": null,
    "quality": 95,
    "enable_interactive_seg": false,
    "interactive_seg_model": "sam2_1_tiny",
    "interactive_seg_device": "cpu",
    "enable_remove_bg": false,
    "remove_bg_device": "cpu",
    "remove_bg_model": "briaai/RMBG-1.4",
    "enable_anime_seg": false,
    "enable_realesrgan": false,
    "realesrgan_device": "cpu",
    "realesrgan_model": "realesr-general-x4v3",
    "enable_gfpgan": false,
    "gfpgan_device": "cpu",
    "enable_restoreformer": false,
    "restoreformer_device": "cpu",
    "model_dir": "D:\\Projects\\fast\\fast-creator\\models",
    "mode": 0
}

1. 交互式分割

将 enable_interactive_seg 改为 true

2. 背景去除

将 enable_remove_bg 改为 true

3. 高清增强

将 enable_realesrgan 改为 true

4. 面部修复

将 enable_realesrgan、enable_gfpgan 改为 true

注意

• mode 模式切换，0：单图模式、1：文件夹模式

• 文件夹模式下，上述功能生效

示例説明

👇 去除左上角文字、及花瓣

输入	输出

1. 点击 Iopaint 等待启动

2. 上传图像并涂抹标记

2.1 文件上传

上传	标记

2.2 文件夹选择

选择	标记

3. 自动去除并预览效果