aibyte

Appearance

MagicQuill：智能的交互式图像编辑系统 ​

官方文档

https://github.com/ant-research/MagicQuill

功能介绍 ​

MagicQuill 核心能力聚焦在三个画笔工具，分别如下：

  1. 添加画笔：根据自己的需求在图像进行涂抹，之后使用自然语言来控制该涂抹部分的图像生成，如下图所示在森林中添加一只鹿 addQuill.gif
  2. RGB画笔：选择画笔颜色，根据自己的需求在图像进行涂抹，之后精准的修改涂抹部位的颜色，如下图所示修改女孩的发色 rgbQuill.gif
  3. 清除画笔：清除任意不想要的元素，如上图所示将女孩的长发剪为短发，清除画笔更常见的一个用途是去水印，涂抹到水印部分，不输入任何的提示词，直接运行即可

另外，多个画笔可以同时相互配合使用，比如下图所示，用清除画笔去除男人的领带，同时使用添加画笔增加领结 addAndSubstractQuill.gif

一键整合包 ​

下载地址：百度网盘 安装方式：下载后，选择文件夹中的所有文件（约31G），右键选择“7-Zip” => “Extract Here”，解压完成后，双击压缩包中的 “启动.bat” 文件即可启动程序。如果想要自行进行安装，继续查看“安装应用”小节。

安装应用 ​

系统要求：需要 GPU 支持,且显存大小需要 8G 以上。 下面以 Windows11 为例，演示安装流程，在 cmd 中依次输入以下命令

shell
cd D:\ai\self_use_package // 选择软件安装的目标目录
git clone --recursive https://github.com/magic-quill/MagicQuill.git // 下载源码
cd MagicQuill // 进入源码目录
wget -O models.zip "https://hkustconnect-my.sharepoint.com/:u:/g/personal/zliucz_connect_ust_hk/EWlGF0WfawJIrJ1Hn85_-3gB0MtwImAnYeWXuleVQcukMg?e=Gcjugg&download=1" // 下载模型，共 25G 左右，耐心等候
unzip models.zip // 解压模型
conda create -n magicQuill python=3.10 -y // 创建虚拟环境
conda activate magicQuill // 激活虚拟环境
pip install torch==2.1.2 torchvision==0.16.2 torchaudio==2.1.2 --index-url https://download.pytorch.org/whl/cu118 // 安装 torch/cuda/cudnn 以支持 gpu
pip install gradio_magicquill-0.0.1-py3-none-any.whl // 安装 gradio_magicquill，支持 web 界面访问
Copy-Item -Path pyproject.toml -Destination "MagicQuill\LLaVA" -Force // 在 powershell 中执行
pip install -e MagicQuill\LLaVA\ // 安装 LLaVA 依赖
pip install -r requirements.txt  // 安装 MagicQuill 依赖

如果后续需要更新应用，则进入 MagicQuill 源码目录后：

shell
git pull // 拉取最新代码
conda activate magicQuill // 激活虚拟环境
pip uninstall -y gradio_magicquill-0.0.1-py3-none-any.whl
pip install gradio_magicquill-0.0.1-py3-none-any.whl // 重新安装 gradio_magicquill

启动应用 ​

在 cmd 中输入以下命令

shell
python gradio_run.py // 启动程序

在 cmd 中看到如下日志，表示成功（首次启动会从 HuggingFace 上拉取模型）

shell
INFO:     Started server process [25096]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://127.0.0.1:7860 (Press CTRL+C to quit)

此时浏览器输入 http://127.0.0.1:7860，展示界面如下

MagicQuillUI.png

详细用法 ​

核心的三种笔刷能力，在文章开头已经展示过，此处不再展示。此处核心介绍下 MagicQuill 的参数设置。通常情况下，我们只需要关注基础模型/负面提示即可。

  1. 基础模型名称：可以调整此项以选择适合不同编辑风格的基础模型
    • SD1.5/realisticVisionV60B1_v51VAE.safetensors：现实风格
    • SD1.5/DreamShaper.safetensors：幻想风格
    • SD1.5/majicMIX_realistic：肖像生成
    • SD1.5/MeinaMix.safetensors：动漫风格
    • SD1.5/ghostmix_v20Bakedvae.safetensors：动漫风格
  2. 负面提示：可以输入希望模型避免生成的内容。你不想生成什么就放在这里。
  3. 精细边缘：可以启用此选项来激活精细边缘控制。
  4. 增大尺寸：调整此参数可设置编辑图像时笔触周围受影响的像素范围，以扩大/缩小笔触影响区域。
  5. 边缘强度：用于调整添加/减去画笔控制强度的参数。
  6. 颜色强度：调整颜色画笔控制强度的参数，可以调整图像的着色效果。
  7. 剩余的采样种子/采样步数/CFG/采样器/调度器是扩散模型的常用参数，通常不用修改。

文章的最后，如果您觉得本文对您有用，请打赏一杯咖啡！感谢！

Copyright © 2025 赵王心玥