> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# AI 이미지 생성 시작하기

> 이 튜토리얼에서는 ComfyUI를 사용해 첫 번째 이미지 생성을 안내하며, 워크플로드 로딩, 모델 설치, 이미지 생성과 같은 기본 인터페이스 작업을 다룹니다.

<Note>
  이 가이드는 자신의 기기에서 ComfyUI를 실행하는 **로컬 사용자**를 대상으로 합니다. 로컬에 아무것도 설치하지 않으려면 공식 클라우드 서비스를 이용해 보세요.
</Note>

<Card title="Comfy Cloud 사용해보기" icon="cloud" href="http://cloud.comfy.org/?template=image_z_image_turbo&utm_source=docs">
  설정 없이 온라인에서 ComfyUI를 실행하세요. 구글 계정으로 로그인하면 **매달 400 크레딧 무료 제공**됩니다.
</Card>

이 가이드는 ComfyUI의 기본 작동 방식을 이해하고 첫 번째 이미지를 완성하는 데 도움을 드립니다. 다음 내용을 다룹니다:

1. 예제 워크플로드 로딩
   * ComfyUI 워크플로드 템플릿에서 로딩하기
   * 워크플로드 메타데이터가 포함된 이미지에서 로딩하기
2. 모델 설치 안내
   * 자동 모델 설치
   * 수동 모델 설치
3. 첫 번째 텍스트-to-이미지 생성 완료

## 텍스트-to-이미지란?

텍스트-to-이미지는 텍스트 설명을 바탕으로 이미지를 생성하는 기본적인 AI 드로잉 기능입니다. AI 아트 생성에서 가장 많이 사용되는 기능 중 하나입니다. 이 과정을 생각해보면, 당신의 요구사항(긍정적 및 부정적 프롬프트)을 아티스트(드로잉 모델)에게 전달하고, 아티스트는 당신이 원하는 것을 만들어냅니다. 텍스트-to-이미지에 대한 자세한 설명은 [텍스트 to 이미지](/ko/tutorials/basic/text-to-image) 챕터에서 다룹니다.

## ComfyUI 텍스트-to-이미지 워크플로드 튜토리얼

### 1. ComfyUI 실행하기

[설치 가이드](/ko/installation/system_requirements)를 따라 ComfyUI를 시작하고 성공적으로 ComfyUI 인터페이스에 진입했는지 확인하세요. 또는 [Comfy Cloud](/ko/get_started/cloud)를 이용하면 설치 없이 ComfyUI를 바로 사용할 수 있습니다.

<img src="https://mintcdn.com/dripart/-uf1LbfqYw9IrpmN/images/desktop/comfyui-interface.jpg?fit=max&auto=format&n=-uf1LbfqYw9IrpmN&q=85&s=5fc5c0932897a4ab0076db79fec7b4ea" alt="ComfyUI 인터페이스" width="2000" height="1414" data-path="images/desktop/comfyui-interface.jpg" />

ComfyUI를 설치하지 않았다면, 기기에 맞는 버전을 선택해 설치해주세요.

<AccordionGroup>
  <Accordion title="Comfy 데스크톱">
    Comfy 데스크톱은 현재 \*\*Windows 및 MacOS (ARM)\*\*용 독립형 설치를 지원하며, 현재 베타 버전입니다.

    * 코드는 [Github](https://github.com/Comfy-Org/desktop)에서 오픈소스로 제공됩니다.

    <Tip>
      데스크톱은 항상 **안정적인 릴리스**를 기반으로 구축되기 때문에, 최신 업데이트를 바로 경험하기까지 다소 시간이 걸릴 수 있습니다. 항상 최신 버전을 경험하고 싶다면 휴대용 버전이나 수동 설치 방법을 사용해 주세요.
    </Tip>

    아래에서 시스템과 하드웨어에 맞는 적절한 설치 방법을 선택할 수 있습니다.

    <Tabs>
      <Tab title="Windows">
        <Card title="Comfy 데스크톱 (Windows) 설치 가이드" icon="link" href="/ko/installation/desktop/windows">
          **Windows** 버전에서 **Nvidia** GPU를 사용하는 경우에 적합합니다.
        </Card>
      </Tab>

      <Tab title="MacOS(애플 실리콘)">
        <Card title="Comfy 데스크톱 (MacOS) 설치 가이드" icon="link" href="/ko/installation/desktop/macos">
          **애플 실리콘**을 탑재한 MacOS에 적합합니다.
        </Card>
      </Tab>

      <Tab title="Linux">
        <Note>Comfy 데스크톱은 현재 **Linux용 사전 빌드가 없습니다**, [수동 설치](/ko/installation/manual_install) 섹션을 방문하여 ComfyUI를 설치해 주세요.</Note>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="ComfyUI 휴대용 (Windows)">
    휴대용 버전은 독립적인 임베디드 파이썬 환경을 통합한 ComfyUI 버전으로, 휴대용 버전을 사용하면 최신 기능을 경험할 수 있습니다. 현재 **Windows** 시스템만 지원합니다.

    <Card title="ComfyUI 휴대용 (Windows) 설치 가이드" icon="link" href="/ko/installation/comfyui_portable_windows">
      **Windows** ComfyUI 버전이 **Nvidia GPU** 또는 **CPU 전용**으로 실행되며, 항상 최신 커밋을 사용하고 완벽히 휴대 가능합니다.
    </Card>
  </Accordion>

  <Accordion title="수동 설치">
    <Card title="ComfyUI 수동 설치 가이드" icon="link" href="/ko/installation/manual_install">
      모든 시스템 유형 및 GPU 유형(Nvidia, AMD, Intel, 애플 실리콘, Ascend NPU, Cambricon MLU)을 지원합니다.
    </Card>
  </Accordion>
</AccordionGroup>

### 2. 기본 텍스트-to-이미지 워크플로드 로딩하기

ComfyUI는 보통 실행 시 기본 텍스트-to-이미지 워크플로드를 자동으로 로드합니다. 하지만 다양한 방법으로 워크플로드를 로드해 ComfyUI의 기본 작동 방식을 익힐 수 있습니다:

<Tabs>
  <Tab title="워크플로드 템플릿에서 로딩하기">
    <img src="https://mintcdn.com/dripart/Y1vvksJIVhyGxEpl/images/tutorial/gettingstarted/sidebar_template.png?fit=max&auto=format&n=Y1vvksJIVhyGxEpl&q=85&s=21ba5bae078af1b47ecdb23319f4d788" alt="ComfyUI 인터페이스" width="1208" height="908" data-path="images/tutorial/gettingstarted/sidebar_template.png" />

    이미지에 표시된 숫자 순서대로 따라가세요:

    1. 오른쪽 하단의 **뷰 조정** 버튼을 클릭해 로드된 워크플로드가 잘 보이는지 확인하세요
    2. 사이드바에서 \*\*폴더 아이콘(워크플로드)\*\*을 클릭하세요
    3. 워크플로드 패널 상단의 **예제 워크플로드 탐색** 버튼을 클릭하세요

    계속해서:

    <img src="https://mintcdn.com/dripart/Y1vvksJIVhyGxEpl/images/tutorial/gettingstarted/template_library_default_workflow.png?fit=max&auto=format&n=Y1vvksJIVhyGxEpl&q=85&s=f58afb4ee18b0323fa8ba3fe87f365a9" alt="워크플로드 로딩" width="1200" height="815" data-path="images/tutorial/gettingstarted/template_library_default_workflow.png" />

    4. 첫 번째 기본 워크플로드인 **이미지 생성**을 선택해 로드하세요
  </Tab>

  <Tab title="메타데이터가 포함된 이미지에서 로딩하기">
    ComfyUI가 생성한 모든 이미지는 워크플로드 정보를 포함한 메타데이터를 가지고 있습니다. 다음과 같은 방법으로 워크플로드를 로드할 수 있습니다:

    * ComfyUI가 생성한 이미지를 인터페이스로 드래그 앤 드롭하기
    * 메뉴 **워크플로드** -> **열기**를 사용해 이미지를 열기

    이 예제 이미지를 사용해 워크플로드를 로드해보세요:
    ![ComfyUI-텍스트 to 이미지 워크플로드](https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/text-to-image-workflow.png)
  </Tab>

  <Tab title="workflow.json에서 로딩하기">
    ComfyUI 워크플로드는 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" }}>텍스트 to 이미지.json 다운로드</p>
    </a>

    다운로드 후 메뉴 **워크플로드** -> **열기**를 사용해 JSON 파일을 로드하세요.
  </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) 모델이 설치되지 않았다면, 다음과 같은 알림이 나타납니다:

먼저 ComfyUI는 일부 모델이 누락되었음을 경고합니다:

<img src="https://mintcdn.com/dripart/Y1vvksJIVhyGxEpl/images/tutorial/gettingstarted/missing_model_warning_1.png?fit=max&auto=format&n=Y1vvksJIVhyGxEpl&q=85&s=0587d7f045f981756c232644569b3b59" alt="모델 누락 경고" width="1200" height="814" data-path="images/tutorial/gettingstarted/missing_model_warning_1.png" />

경고를 클릭해 어떤 모델이 누락되었는지와 다운로드 링크를 확인하세요:

<img src="https://mintcdn.com/dripart/Y1vvksJIVhyGxEpl/images/tutorial/gettingstarted/missing_model_warning_2.png?fit=max&auto=format&n=Y1vvksJIVhyGxEpl&q=85&s=bf61da1c5711d935b7d49dd7e236f275" alt="모델 누락 세부정보" width="1200" height="812" data-path="images/tutorial/gettingstarted/missing_model_warning_2.png" />

모델은 `<ComfyUI 설치 위치>/ComfyUI/models/` 아래에 저장되며, `checkpoints`, `embeddings`, `vae`, `lora`, `upscale_model` 등 하위 폴더로 구성됩니다. ComfyUI는 시작 시 `extra_model_paths.yaml`에 설정된 폴더와 경로에서 모델을 감지합니다.

<Tabs>
  <Tab title="Comfy 데스크톱 (모델 폴더 찾기)">
    <img src="https://mintcdn.com/dripart/Y1vvksJIVhyGxEpl/images/tutorial/gettingstarted/desktop_model_folder_path.png?fit=max&auto=format&n=Y1vvksJIVhyGxEpl&q=85&s=583ed638f72345a36464c7cfbb6f1eaa" alt="데스크톱 모델 폴더 경로" width="2004" height="1442" data-path="images/tutorial/gettingstarted/desktop_model_folder_path.png" />

    **Comfy 데스크톱**에서는 모델 폴더 위치가 포터블/기타 설치와 다를 수 있습니다. 다음 단계를 따르세요:

    1. 왼쪽 상단의 **로고**를 클릭하세요
    2. **도움말** → **폴더 열기**를 선택하세요
    3. **모델 폴더 열기**를 선택하세요

    인터페이스 언어가 다른 경우 메뉴 명칭은 다를 수 있지만, 동일한 흐름을 따릅니다: **도움말** → **폴더 열기** → **모델 폴더 열기**(또는 해당 언어에 가장 가까운 표현).
  </Tab>

  <Tab title="ComfyUI 포터블 (모델 폴더 찾기)">
    포터블 버전의 경우 모델 폴더는 보통 다음 위치에 있습니다:

    `ComfyUI_windows_portable/ComfyUI/models/`
  </Tab>
</Tabs>

다음과 같은 방법으로 모델을 설치할 수 있습니다:

<Tabs>
  <Tab title="자동 다운로드">
    **다운로드** 버튼을 클릭하면 ComfyUI가 다운로드를 실행하며, 사용 중인 버전에 따라 다른 동작을 수행합니다.

    <Tabs>
      <Tab title="Comfy 데스크톱">
        데스크톱 버전은 모델 다운로드를 자동으로 완료하고 `<ComfyUI 설치 위치>/ComfyUI/models/checkpoints` 디렉토리에 저장합니다.
        설치가 완료될 때까지 기다리거나 사이드바의 모델 패널에서 설치 진행 상황을 확인할 수 있습니다.

        <img src="https://mintcdn.com/dripart/Y1vvksJIVhyGxEpl/images/tutorial/gettingstarted/desktop_download_status.png?fit=max&auto=format&n=Y1vvksJIVhyGxEpl&q=85&s=a1573451803b46539fca14c1b1ef4dd2" alt="모델 다운로드 진행 상태" width="1200" height="821" data-path="images/tutorial/gettingstarted/desktop_download_status.png" />

        <Warning>
          자동 다운로드는 일반적으로 **Hugging Face**에서 모델을 가져옵니다. 네트워크가 Hugging Face에 안정적으로 연결될 수 있는지 확인하세요.

          만약 다운로드가 **시작되지 않거나 오랜 시간 동안 진행되지 않는다면**, 누락된 모델 세부정보에서 모델 링크를 복사하거나 아래의 수동 설치 섹션을 참고해 직접 설치하세요.
        </Warning>
      </Tab>

      <Tab title="ComfyUI 포터블">
        브라우저가 파일 다운로드를 실행합니다. 다운로드가 완료된 후 `<ComfyUI 설치 위치>/ComfyUI_windows_portable/ComfyUI/models/checkpoints` 디렉토리에 파일을 저장하세요.
      </Tab>
    </Tabs>
  </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/TwfNQ2dEaWQA7tIL/images/tutorial/gettingstarted/first-image-generation-5-hugging-face.jpg?fit=max&auto=format&n=TwfNQ2dEaWQA7tIL&q=85&s=15c2560c44e7e4276b6a351809f7bf9f" alt="Hugging Face 모델 다운로드" width="769" height="727" data-path="images/tutorial/gettingstarted/first-image-generation-5-hugging-face.jpg" />

    다운로드한 파일을 다음 위치에 저장하세요:

    <Tabs>
      <Tab title="Comfy 데스크톱">
        `<ComfyUI 설치 위치>/ComfyUI/models/checkpoints`에 저장하세요

        <img src="https://mintcdn.com/dripart/TwfNQ2dEaWQA7tIL/images/tutorial/gettingstarted/first-image-generation-6-2-desktop.jpg?fit=max&auto=format&n=TwfNQ2dEaWQA7tIL&q=85&s=275add7233b1f048455cff0f162847b9" alt="Comfy 데스크톱 모델 저장 위치" 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/TwfNQ2dEaWQA7tIL/images/tutorial/gettingstarted/first-image-generation-6-1-portable.jpg?fit=max&auto=format&n=TwfNQ2dEaWQA7tIL&q=85&s=48976b87bcfdba962b119d901c43b286" alt="ComfyUI 포터블 모델 저장 위치" width="1081" height="709" data-path="images/tutorial/gettingstarted/first-image-generation-6-1-portable.jpg" />
      </Tab>
    </Tabs>

    저장 후 ComfyUI를 새로 고침하거나 재시작하세요.
  </Tab>
</Tabs>

### 4. 모델 로드하고 첫 번째 이미지 생성하기

모델을 설치하거나 업데이트한 후, 키보드에서 \*\*`R`\*\*을 눌러 객체 정의를 새로 고치고 노드의 모델 목록을 업데이트하세요(예: **Load Checkpoint**의 드롭다운). 이후 아래 단계를 따라 진행하세요:

<img src="https://mintcdn.com/dripart/Y1vvksJIVhyGxEpl/images/tutorial/gettingstarted/run_workflow.png?fit=max&auto=format&n=Y1vvksJIVhyGxEpl&q=85&s=d8cb64b219e93cfd903723255d5e7d11" alt="워크플로드 실행" width="1200" height="881" data-path="images/tutorial/gettingstarted/run_workflow.png" />

1. **Load Checkpoint** 노드에서 **v1-5-pruned-emaonly-fp16.safetensors**가 선택되었는지 확인하세요
2. **실행**을 클릭하거나 **Ctrl + Enter**를 눌러 생성하세요

결과는 **Save Image** 노드에 나타납니다. 마우스 오른쪽 버튼을 클릭해 로컬에 저장하세요.

<img src="https://mintcdn.com/dripart/Y1vvksJIVhyGxEpl/images/tutorial/gettingstarted/result.png?fit=max&auto=format&n=Y1vvksJIVhyGxEpl&q=85&s=dd253cd626d72716f52322245c5526cc" alt="ComfyUI 첫 번째 이미지 생성 결과" width="1200" height="952" data-path="images/tutorial/gettingstarted/result.png" />

자세한 텍스트-to-이미지 지침은 종합 가이드를 참조하세요:

<Card title="ComfyUI 텍스트-to-이미지 워크플로드 가이드" icon="link" href="/ko/tutorials/basic/text-to-image">
  자세한 텍스트-to-이미지 워크플로드 지침은 여기를 클릭하세요
</Card>

## 문제 해결

### 모델 로딩 문제

**Load Checkpoint** 노드에 모델이 표시되지 않거나 "null"이라고 나오는 경우, 모델 설치 위치를 확인하고 ComfyUI를 새로 고치거나 재시작해보세요.
