> ## 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.

# Gemma 4 ComfyUI 워크플로 예시

> Gemma 4는 구글의 멀티모달 LLM 제품군으로, 텍스트 생성, 이미지 이해, 비디오 분석 및 오디오 전사를 지원하며 최대 256K 컨텍스트를 처리합니다. 2B, 4B, 31B 크기로 제공됩니다.

<Tip>
  <Tabs>
    <Tab title="로컬 사용자">
      ComfyUI가 최신 버전으로 업데이트되었는지 확인하세요.

      * [ComfyUI 다운로드](https://www.comfy.org/download)
      * [업데이트 가이드](/ko/installation/update_comfyui)

      이 가이드의 워크플로우는 [워크플로우 템플릿](/ko/interface/features/template)에서 확인할 수 있습니다.
      템플릿에서 찾을 수 없다면, 귀하의 ComfyUI가 오래된 버전일 수 있습니다.

      워크플로우를 로드할 때 노드가 누락되는 경우, 가능한 원인:

      1. 최신 ComfyUI 버전(야간 빌드)을 사용하고 있지 않음
      2. 일부 노드가 시작 시 가져오기에 실패함
    </Tab>

    <Tab title="클라우드 사용자">
      * [클라우드](https://cloud.comfy.org)는 ComfyUI 안정판 출시 후 업데이트됩니다.

      따라서 이 문서에서 핵심 노드가 누락된 것을 발견했다면, 그 이유는 새로운 핵심 노드가 아직 최신 안정판에 공개되지 않았기 때문일 수 있습니다. 다음 안정판 출시를 기다려 주세요.
    </Tab>
  </Tabs>
</Tip>

**Gemma 4**는 구글 딥마인드에서 개발한 경량 오픈 LLM의 최신 세대이며, 텍스트 생성, 이미지 이해, 비디오 분석, 오디오 전사 및 구조화된 도구 사용을 위해 설계되었습니다. ComfyUI에서는 기본 **텍스트 생성** 모델로 원활하게 지원됩니다.

**모델 주요 특징**:

* **멀티모달 설계** — 텍스트, 이미지, 비디오, 오디오 입력을 동시에 수용합니다.
* **세 가지 크기 제공**:
  * **E2B (2B)** — 빠르고 가벼워 소비자용 GPU에 적합합니다.
  * **E4B (4B)** — 균형 잡힌 성능으로, 권장되는 기본 모델입니다.
  * **31B** — 최고의 품질을 제공하며 더 높은 VRAM이 필요합니다.
* **사고 모드** — 답변 생성 전 내장된 단계별 추론 기능
* **긴 컨텍스트** — 최대 128K 토큰(E2B/E4B) 및 256K 토큰(31B)
* **다국어 지원** — 기본적으로 35개 이상의 언어를 지원하며, 140개 이상의 언어로 사전 학습됨
* **함수 호출** — 구조화된 도구 사용 및 에이전트 기반 워크플로에 대한 기본 지원
* **ComfyUI 기본 지원** — 내장된 `TextGenerate` 및 `CLIPLoader` 노드를 통해 로드되고 실행됩니다.

**관련 링크**:

* [Hugging Face (Comfy-Org/gemma-4)](https://huggingface.co/Comfy-Org/gemma-4)
* [Google AI for Developers](https://ai.google.dev/gemma)
* [ComfyUI 소스 코드 (nodes\_textgen.py)](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy_extras/nodes_textgen.py)

## 이용 가능한 워크플로

### Gemma 4: 텍스트 생성

<Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/llm_gemma4_text_gen.json">
  JSON 파일을 다운로드하거나 템플릿 라이브러리에서 "Gemma 4 텍스트 생성"을 검색하세요.
</Card>

<Card title="Comfy Cloud에서 실행하기" icon="cloud" href="https://cloud.comfy.org/?template=llm_gemma4_text_gen&utm_source=docs&utm_medium=referral&utm_campaign=gemma4">
  Comfy Cloud에서 열기
</Card>

![Gemma 4 텍스트 생성 워크플로](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/llm_gemma4_text_gen-1.webp)

이 워크플로는 Gemma 4의 핵심 **텍스트 생성** 기능을 보여줍니다. 텍스트 프롬프트와 함께 추가적인 컨텍스트로 이미지, 오디오 파일 또는 비디오를 선택할 수 있으며, 자연어 출력을 생성합니다. 추론, 코딩 및 다국어 프롬프트까지 지원합니다.

**입력**:

* **텍스트 프롬프트** — 질문이나 지침
* **이미지** (선택사항) — 시각적 이해 작업용 (OCR, 객체 감지, 차트 읽기 등)
* **오디오** (선택사항) — 음성 인식 또는 오디오 전사용
* **비디오** (선택사항) — 프레임별 비디오 이해용 (내부적으로 1 FPS로 하위 샘플링됨)

**주요 제어 옵션**:

* **최대 길이** — 생성할 최대 토큰 수 (기본값 256)
* **샘플링 모드** — 샘플링 켜기/끄기 및 온도, top-k, top-p, 반복 페널티, 시드 조정 가능
* **사고 모드** — 최종 답변 전 단계별 추론 활성화
* **기본 템플릿 사용** — 모델에 맞는 내장 시스템 프롬프트 적용

**출력**:

* **생성된 텍스트** — 모델의 응답을 일반 텍스트 문자열로 반환

<Card title="서브그래프 알아보기" icon="book-open" href="/ko/interface/features/subgraph">
  이 워크플로는 서브그래프 노드를 사용해 모듈식 처리를 수행합니다. 서브그래프 문서를 확인하여 워크플로를 사용자 정의하고 확장하는 방법을 배워보세요.
</Card>

## 모델 다운로드

Gemma 4 모델은 ComfyUI에서 텍스트 인코더로 로드됩니다. 관련 모델 파일을 다운로드하여 올바른 디렉토리에 저장하세요:

<Card title="Gemma 4 2B (E2B IT FP8)" icon="download" href="https://huggingface.co/Comfy-Org/gemma-4/resolve/main/text_encoders/gemma4_e2b_it_fp8_scaled.safetensors">
  빠르고 가벼움. 소비자용 GPU에 권장됩니다.
</Card>

<Card title="Gemma 4 4B (E4B IT FP8)" icon="download" href="https://huggingface.co/Comfy-Org/gemma-4/resolve/main/text_encoders/gemma4_e4b_it_fp8_scaled.safetensors">
  균형 잡힌 성능. 워크플로의 기본 모델입니다.
</Card>

<Card title="모든 변형 보기" icon="external-link" href="https://huggingface.co/Comfy-Org/gemma-4/tree/main/text_encoders">
  모든 Gemma 4 모델 가중치 찾아보기.
</Card>

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

```
📂 ComfyUI/
├── 📂 models/
│   └── 📂 text_encoders/
│       └── gemma4_e4b_it_fp8_scaled.safetensors
```