> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-lora-training-1772768349.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 开始 ComfyUI 的 AI 绘图之旅

> 本部分教程将会带你完成首次 ComfyUI 的图片生成，了解并熟悉 ComfyUI 中的一些界面基础操作，如工作流加载、模型安装、图片生成等

本篇的主要目的是带你初步了解 ComfyUI 熟悉 ComfyUI 的一些基础操作，并引导你首次的图片生成

1. 加载示例工作流
   * 从 ComfyUI 加载`Workflows template`中的`Text to Image`工作流
   * 使用带有`metadata` 的图片中加载工作流
2. 指导你完成模型
   * 自动安装模型
   * 手动安装模型
   * 使用 **ComfyUI Manager** 的模型管理功能安装模型
3. 进行一次文本到图片的生成

## 关于文生图的说明

**文生图（Text to Image）**，是 AI 绘图的基础，通过输入文本描述来生成对应的图片，是 AI 绘图最常用的功能之一，你可以理解成你把你的**绘图要求(正向提示词、负向提示词)**告诉一个**画家(绘图模型)**，画家会根据你的要求，画出你想要的内容，由于本篇教程主要是为了引导你开始 ComfyUI 的使用，对于文生图的详细说明，我们将在[文生图](/zh/tutorials/basic/image-to-image)章节进行详细讲解

## ComfyUI 文生图工作流教程讲解

### 1. 启动 ComfyUI

请确定你已经按照[安装指南](/zh/installation/system_requirements)完成了 ComfyUI 的启动，并可以成功打开 ComfyUI 的页面。或者，你也可以使用 [Comfy Cloud](/zh/get_started/cloud) 在云端使用 ComfyUI，无需安装。

<img src="https://mintcdn.com/dripart-docs-lora-training-1772768349/LAZLPLoD8wVaF21_/images/desktop/comfyui-interface.jpg?fit=max&auto=format&n=LAZLPLoD8wVaF21_&q=85&s=67b9fe4d283b3779e57279a42f347d2c" alt="ComfyUI界面" width="2000" height="1414" data-path="images/desktop/comfyui-interface.jpg" />

如果你还未安装 ComfyUI 请根据你的设备情况选择一个合适的版本进行安装

<AccordionGroup>
  <Accordion title="ComfyUI 桌面版">
    ComfyUI 桌面版目前支持 **Windows 及 MacOS(Apple Silicon)** 的独立安装，目前仍在 Beta 版本

    * 代码开源在 [Github](https://github.com/Comfy-Org/desktop)

    <Tip>
      由于 Desktop 总是基于稳定版本发布构建，所以我们最新的一些更新，对于 Desktop 来说可能需要等待一段时间才能体验到，如果你想要总是体验最新版本，请使用便携版或者手动安装
    </Tip>

    你可以从下面选择适合你的系统和硬件开始安装 ComfyUI

    <Tabs>
      <Tab title="Windows">
        <Card title="ComfyUI桌面版(Windows)安装指南" icon="link" href="/zh/installation/desktop/windows">
          适合带有 **Nvdia** 显卡 **Windows** 版本的 ComfyUI 桌面版
        </Card>
      </Tab>

      <Tab title="MacOS(Apple Silicon)">
        <Card title="ComfyUI桌面版(MacOS)安装指南" icon="link" href="/zh/installation/desktop/macos">
          适合带有 **Apple Silicon** 的 MacOS ComfyUI 桌面版
        </Card>
      </Tab>

      <Tab title="Linux">
        <Note>ComfyUI桌面版，**暂时没有 Linux 的预构建**，请访问[手动安装](/zh/installation/manual_install)部分进行 ComfyUI 的安装</Note>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="ComfyUI 便携版(Windows)">
    便携版是一个集成了独立的嵌入式 Python 环境的 ComfyUI 版本，使用便携版你可以体验到最新的功能，目前仅支持 **Windows** 系统

    <Card title="ComfyUI桌面版(Windows)安装指南" icon="link" href="/zh/installation/comfyui_portable_windows">
      支持 **Navida 显卡** 和在 **CPU** 运行的 **Windows** ComfyUI 版本，始终使用最新 commit 的代码
    </Card>
  </Accordion>

  <Accordion title="手动安装 ComfyUI">
    <Card title="ComfyUI 手动安装教程" icon="link" href="/zh/installation/manual_install">
      支持所有的系统类型和 GPU 类型（Nvidia、AMD、Intel、Apple Silicon、Ascend NPU、寒武纪 MLU）的用户都可以尝试使用手动安装 ComfyUI
    </Card>
  </Accordion>
</AccordionGroup>

### 2. 加载默认文生图工作流

正常情况下，打开 ComfyUI 后是会自动加载默认的文生图工作流的, 不过你仍旧可以尝试以下不同方式加载工作流来熟悉 ComfyUI 的一些基础操作

<Tabs>
  <Tab title="从 Workflow Template 加载">
    <img src="https://mintcdn.com/dripart-docs-lora-training-1772768349/YYmqLliLu5SOu2JU/images/tutorial/gettingstarted/first-image-generation-1.jpg?fit=max&auto=format&n=YYmqLliLu5SOu2JU&q=85&s=cb858c7cd25d14c4df3c8f29a001d5a2" alt="ComfyUI 界面" width="973" height="696" data-path="images/tutorial/gettingstarted/first-image-generation-1.jpg" />

    请对照图片中序号所对应的顺序进行操作

    1. 点击 ComfyUI 界面右下角的**Fit View**按钮，防止已加载工作流是在视图外导致不可见
    2. 点击侧边栏的**文件夹图标（workflows）**
    3. 点击 工作流（Workflows）面板顶部的**浏览工作流示例（Browse example workflows）** 按钮

    下图继续

    <img src="https://mintcdn.com/dripart-docs-lora-training-1772768349/YYmqLliLu5SOu2JU/images/tutorial/gettingstarted/first-image-generation-2-load-workflow.jpg?fit=max&auto=format&n=YYmqLliLu5SOu2JU&q=85&s=6aa2ca4b34ad6b2b1c76c78a188bd683" alt="加载工作流" width="972" height="692" data-path="images/tutorial/gettingstarted/first-image-generation-2-load-workflow.jpg" />

    4. 选择默认的第一个工作流 **Image Generation** 以加载图标

    或者你也可以从`workflow`菜单中选择**Browse workflow templates** 浏览工作流模板

    <img src="https://mintcdn.com/dripart-docs-lora-training-1772768349/YYmqLliLu5SOu2JU/images/tutorial/gettingstarted/first-image-generation-1-menu.jpg?fit=max&auto=format&n=YYmqLliLu5SOu2JU&q=85&s=1d1f42ca41b0805d52309eebad6a7b19" alt="ComfyUI 菜单 - 浏览工作流模板" width="612" height="536" data-path="images/tutorial/gettingstarted/first-image-generation-1-menu.jpg" />
  </Tab>

  <Tab title="从带有 metadata 的图片中加载">
    所有用 ComfyUI 生成的图片，都会带有 metadata 信息，这些信息会包含图片的 workflow 信息，你可以通过这些信息来加载对应的 workflow。

    现在，让我们尝试一下，请保存下面的工作流图片，然后直接拖入 ComfyUI 的界面中，或者使用菜单 **工作流（Workflows）** -> **打开（Open）** 打开这个图片以加载对应的 workflow

    ![ComfyUI-文生图工作流](https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/text-to-image-workflow.png)
  </Tab>

  <Tab title="从 workflow.json 文件中加载">
    ComfyUI 工作流还可以 json 格式存储，当我们完成一个工作流后，可以使用菜单 **工作流（Workflows）** -> **导出（Export）** 导出，这样对应的工作流就可以被保存为 json 文件中加载

    现在，让我们尝试一下，点击下面的按钮，前往 Github 下载对应的 text-to-image.json 文件

    <a className="prose" href="https://github.com/Comfy-Org/docs/blob/main/public/text-to-image.json" download style={{ display: 'inline-block', backgroundColor: '#0078D6', color: '#ffffff', padding: '10px 20px', borderRadius: '8px', borderColor: "transparent", textDecoration: 'none', fontWeight: 'bold'}}>
      <p className="prose" style={{ margin: 0, fontSize: "0.8rem" }}>前往下载 text-to-image.json 文件</p>
    </a>

    下载完成后，请使用菜单 **工作流（Workflows）** -> **打开（Open）** 打开这个 json 文件以加载对应的 workflow
  </Tab>
</Tabs>

### 3. 安装绘图模型

通常在 ComfyUI 的初始安装中，并不会包含任何的绘图模型，但是模型是我们运行图片生成必不可少的部分。

在你完成第二步，工作流的加载后，如果你的电脑上没有安装[v1-5-pruned-emaonly-fp16.safetensors](https://huggingface.co/Comfy-Org/stable-diffusion-v1-5-archive/blob/main/v1-5-pruned-emaonly-fp16.safetensors) 这个模型文件时，一般会出现下图的提示

<img src="https://mintcdn.com/dripart-docs-lora-training-1772768349/YYmqLliLu5SOu2JU/images/tutorial/gettingstarted/first-image-generation-3-missing-models.jpg?fit=max&auto=format&n=YYmqLliLu5SOu2JU&q=85&s=3317614eae9b3a544fad9a3284a250c8" alt="模型缺失" width="972" height="696" data-path="images/tutorial/gettingstarted/first-image-generation-3-missing-models.jpg" />

你可以直接选择点击 `Download` 按钮，让 ComfyUI 自动完成对应的模型的下载，但由于在有些地区不能够顺利访问对应模型的下载源，所以在这个步骤中，我将说明几种不同的模型安装方法。

无论使用哪种方法，模型都会被保存到 `<你的 ComfyUI 安装位置>/ComfyUI/models/` 文件夹下，你可以在你的电脑上尝试找到这个文件夹位置，你可以看到许多文件夹比如 `checkpoints`、`embeddings`、`vae`、`lora`、`upscale_model` 等，这些都是不同的模型保存的文件夹，通常以文件夹名称区分，ComfyUI 在启动时会检测这些文件夹下的模型文件，以及`extra_model_paths.yaml` 文件中配置的文件路径

<img src="https://mintcdn.com/dripart-docs-lora-training-1772768349/YYmqLliLu5SOu2JU/images/tutorial/gettingstarted/first-image-generation-4-models-folder.jpg?fit=max&auto=format&n=YYmqLliLu5SOu2JU&q=85&s=c0c612d073e4d91a3762190be6f809dc" alt="ComfyUI 模型文件夹" width="1564" height="1228" data-path="images/tutorial/gettingstarted/first-image-generation-4-models-folder.jpg" />

被检测到的不同的文件夹里的模型将可以在 ComfyUI 的不同 **模型加载节点** 里使用，下面让我们开始了解不同模型的安装方式：

<Tabs>
  <Tab title="自动下载模型">
    在你点击 **Download** 按钮后，ComfyUI 将会执行下载,根据你使用的版本不同，将会执行不同的行为

    <Tabs>
      <Tab title="ComfyUI 桌面版">
        桌面版将自动完成模型的下载并保存到 `<你的 ComfyUI 安装位置>/ComfyUI/models/checkpoints` 目录下
        你可以等待安装完成或者在侧边栏的模型面板里查看安装进度

        <img src="https://mintcdn.com/dripart-docs-lora-training-1772768349/YYmqLliLu5SOu2JU/images/tutorial/gettingstarted/first-image-generation-4-download-status.jpg?fit=max&auto=format&n=YYmqLliLu5SOu2JU&q=85&s=745556456e7dfa9c13c0bb751a1a8ca3" alt="模型下载进度" width="974" height="697" data-path="images/tutorial/gettingstarted/first-image-generation-4-download-status.jpg" />

        如果一切顺利，模型应该可以自动下载到本地，如果长时间未下载成功，请尝试其它安装方法
      </Tab>

      <Tab title="ComfyUI 便携版">
        浏览器将会执行文件下载，请在下载完成后，将文件保存到的 `<你的 ComfyUI 安装位置>/ComfyUI_windows_portable/ComfyUI/models/checkpoints` 目录下
      </Tab>
    </Tabs>
  </Tab>

  <Tab title="使用 ComfyUI Manager 安装模型">
    [ComfyUI Manager](https://github.com/ltdrdata/ComfyUI-Manager) 是由 [ltdrdata](https://github.com/ltdrdata) 开发的用于扩展和管理自定义节点、模型及插件的工具，目前 ComfyUI 的安装过程会自动完成 ComfyUI Manager 的安装，下面的步骤将会引导你使用 ComfyUI Manager 安装模型

    <Steps>
      <Step title="打开 ComfyUI Manager">
        <img src="https://mintcdn.com/dripart-docs-lora-training-1772768349/YYmqLliLu5SOu2JU/images/tutorial/gettingstarted/first-image-generation-4-comfyui-manager.jpg?fit=max&auto=format&n=YYmqLliLu5SOu2JU&q=85&s=37113cd2f7cd6c9d7cd1f0e5ae9f915b" alt="ComfyUI Manager 安装" width="492" height="124" data-path="images/tutorial/gettingstarted/first-image-generation-4-comfyui-manager.jpg" />

        如图，点击对应的 `Manager` 按钮，即可打开 ComfyUI Manager 的界面
      </Step>

      <Step title="打开模型管理界面（Model Manager）">
        <img src="https://mintcdn.com/dripart-docs-lora-training-1772768349/YYmqLliLu5SOu2JU/images/tutorial/gettingstarted/first-image-generation-4-comfyui-manager-model-manager.jpg?fit=max&auto=format&n=YYmqLliLu5SOu2JU&q=85&s=87b14157b5e2f2edd408d8786f5716ce" alt="ComfyUI Manager 模型管理" width="1200" height="723" data-path="images/tutorial/gettingstarted/first-image-generation-4-comfyui-manager-model-manager.jpg" />

        如图，点击对应的 `Model Manager` 按钮，即可打开模型管理界面
      </Step>

      <Step title="搜索模型并安装模型">
        <img src="https://mintcdn.com/dripart-docs-lora-training-1772768349/YYmqLliLu5SOu2JU/images/tutorial/gettingstarted/first-image-generation-4-comfyui-manager-download-model.jpg?fit=max&auto=format&n=YYmqLliLu5SOu2JU&q=85&s=b0b4e92759ba52ab8e9525b4cf240e61" alt="ComfyUI Manager 模型下载" width="1200" height="723" data-path="images/tutorial/gettingstarted/first-image-generation-4-comfyui-manager-download-model.jpg" />

        1. 请在搜索框输入`v1-5-pruned-emaonly.ckpt`
        2. 在搜索结果里，点击对应的 `install` 按钮，即可下载模型

        不过由于目前各类模型的更新迭代速度较快，你不一定可以在这里找到所有的模型，另外在某些地区因为无法正常访问 ComfyUI Manager 的模型下载源，所以会存在下载不成功的情况，如果长时间无法下载成功，请尝试手动安装
      </Step>
    </Steps>
  </Tab>

  <Tab title="手动完成模型的安装">
    请访问模型地址：[前往下载 v1-5-pruned-emaonly-fp16.safetensors](https://huggingface.co/Comfy-Org/stable-diffusion-v1-5-archive/blob/main/v1-5-pruned-emaonly-fp16.safetensors)
    参考下面图片完成对应模型的下载

    <img src="https://mintcdn.com/dripart-docs-lora-training-1772768349/YYmqLliLu5SOu2JU/images/tutorial/gettingstarted/first-image-generation-5-hugging-face.jpg?fit=max&auto=format&n=YYmqLliLu5SOu2JU&q=85&s=b132e711f199a2eea4d4afefc1798d39" alt="Hugging Face 模型下载" width="769" height="727" data-path="images/tutorial/gettingstarted/first-image-generation-5-hugging-face.jpg" />

    下载完成后，请将对应的**v1-5-pruned-emaonly-fp16.safetensors** 文件保存到以下位置

    <Tabs>
      <Tab title="ComfyUI 桌面版">
        请找到你在安装过程中设置的 ComfyUI 安装位置，将对应模型文件保存到以下文件夹位置 `<你的 ComfyUI 安装位置>/ComfyUI/models/checkpoints`

        <img src="https://mintcdn.com/dripart-docs-lora-training-1772768349/YYmqLliLu5SOu2JU/images/tutorial/gettingstarted/first-image-generation-6-2-desktop.jpg?fit=max&auto=format&n=YYmqLliLu5SOu2JU&q=85&s=a9bd6045262fa60e0aa12a38f9aac619" alt="ComfyUI 桌面版模型保存位置" width="911" height="710" data-path="images/tutorial/gettingstarted/first-image-generation-6-2-desktop.jpg" />
      </Tab>

      <Tab title="ComfyUI便携版本">
        找到你解压后的便携版的文件夹，在**ComfyUI\_windows\_portable/ComfyUI/models/checkpoints** 文件夹下完成模型的保存

        <img src="https://mintcdn.com/dripart-docs-lora-training-1772768349/YYmqLliLu5SOu2JU/images/tutorial/gettingstarted/first-image-generation-6-1-portable.jpg?fit=max&auto=format&n=YYmqLliLu5SOu2JU&q=85&s=a4df06e3c5111dbb19be1b2edab43e06" alt="ComfyUI 便携版模型保存位置" width="1081" height="709" data-path="images/tutorial/gettingstarted/first-image-generation-6-1-portable.jpg" />
      </Tab>

      <Tab title="其它版本">
        请参考 桌面版和便携版部分的说明查找 **ComfyUI/models/checkpoints**文件夹位置
      </Tab>
    </Tabs>

    完成对应保存操作后，请刷新或者重启 ComfyUI 保证对应模型可以被 ComfyUI 检测
  </Tab>
</Tabs>

### 4. 加载模型，并进行第一次图片生成

在完成了对应的绘图模型安装后，请参考下图步骤加载对应的模型，并进行第一次图片的生成

<img src="https://mintcdn.com/dripart-docs-lora-training-1772768349/YYmqLliLu5SOu2JU/images/tutorial/gettingstarted/first-image-generation-7-queue.jpg?fit=max&auto=format&n=YYmqLliLu5SOu2JU&q=85&s=63cff0a62e017a69ef26ca254cbabb65" alt="图片生成" width="2640" height="1384" data-path="images/tutorial/gettingstarted/first-image-generation-7-queue.jpg" />

请对应图片序号，完成下面操作

1. 请在 **Load Checkpoint** 节点使用箭头或者点击文本区域确保 **v1-5-pruned-emaonly-fp16.safetensors** 被选中，且左右切换箭头不会出现 **null** 的文本
2. 点击 `Queue` 按钮，或者使用快捷键 `Ctrl + enter(回车)` 来执行图片生成

等待对应流程执行完成后，你应该可以在界面的 **保存图像(Save Image)** 节点中看到对应的图片结果，可以在上面右键保存到本地

<img src="https://mintcdn.com/dripart-docs-lora-training-1772768349/YYmqLliLu5SOu2JU/images/tutorial/gettingstarted/first-image-generation-8-result.jpg?fit=max&auto=format&n=YYmqLliLu5SOu2JU&q=85&s=ddc79d82db8060efdd960e2b8be37d9e" alt="ComfyUI 首次图片生成结果" width="2642" height="1390" data-path="images/tutorial/gettingstarted/first-image-generation-8-result.jpg" />

对于文生图的详细说明，下面的指南中会有详细的说明和指导

<Card title="ComfyUI 文生图工作流示例说明" icon="link" href="/zh/tutorials/basic/text-to-image">
  点击这里查看文生图工作流的详细说明
</Card>

## 故障排除

### 模型加载问题

如果 `Load Checkpoint` 节点没有任何模型可以选择，或者显示为 **null**，请先确认你的模型安装位置正确，或者尝试 **刷新** 或者 **重启 ComfyUI** 使得对应文件夹下的模型可以被检测到