> ## 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.
# Qwen 3.0 ComfyUI 워크플로우 예시
> Qwen 3.0은 Alibaba Cloud의 강력한 오픈소스 LLM으로, 강력한 추론 능력을 갖추고 있으며, 텍스트 생성 및 구조화된 추론 작업을 위해 4B 크기로 제공됩니다.
ComfyUI가 최신 버전으로 업데이트되었는지 확인하세요.
* [ComfyUI 다운로드](https://www.comfy.org/download)
* [업데이트 가이드](/ko/installation/update_comfyui)
이 가이드의 워크플로우는 [워크플로우 템플릿](/ko/interface/features/template)에서 확인할 수 있습니다.
템플릿에서 찾을 수 없다면, 귀하의 ComfyUI가 오래된 버전일 수 있습니다. (데스크톱 버전의 업데이트는 다소 지연될 수 있습니다)
워크플로우를 로드할 때 노드가 누락되는 경우, 가능한 원인:
1. 최신 ComfyUI 버전(야간 빌드)을 사용하고 있지 않음
2. 일부 노드가 시작 시 가져오기에 실패함
* 데스크톱 버전은 ComfyUI 안정판 기반으로, 새로운 데스크톱 안정판이 출시되면 자동으로 업데이트됩니다.
* [클라우드](https://cloud.comfy.org)는 ComfyUI 안정판 출시 후 업데이트됩니다.
따라서 이 문서에서 핵심 노드가 누락된 것을 발견했다면, 그 이유는 새로운 핵심 노드가 아직 최신 안정판에 공개되지 않았기 때문일 수 있습니다. 다음 안정판 출시를 기다려 주세요.
**Qwen 3.0**(또는 Qwen3라고도 함)은 Alibaba Cloud가 개발한 강력한 오픈소스 LLM으로, 텍스트 생성, 추론 및 구조적 분석을 위해 설계되었습니다. 이 모델은 내장된 `TextGenerate` 노드를 통해 ComfyUI에서 기본적으로 지원됩니다.
**모델 주요 특징**:
* **강력한 추론** — Qwen3-4B-Thinking은 단계별 사고 체인 추론을 지원합니다.
* **텍스트 생성 중심** — 구조화된 텍스트 출력, 분석 및 코딩 작업에 최적화되어 있습니다.
* **ComfyUI 기본 지원** — 내장된 `TextGenerate` 노드와 함께 작동하며, 커스텀 노드가 필요하지 않습니다.
* **경량성** — Qwen3.5와 동일한 텍스트 인코더 형식을 공유하며, 2B, 4B 및 9B 변형으로 제공되어 다양한 하드웨어에 맞게 사용할 수 있습니다.
## 활용 사례
Qwen 3.0은 ComfyUI 워크플로우 내에서 구조화된 텍스트 생성과 지능형 추론이 필요한 작업에 적합합니다:
* **프롬프트 최적화** — 기존 프롬프트를 Qwen 3.0에 입력하고, 이미지 생성 결과를 더 좋게 만들기 위해 다시 작성하거나 확장하거나 정교하게 다듬도록 요청하세요. 예를 들어, 짧은 키워드 프롬프트를 스타일, 조명, 구성 등의 세부 정보를 포함한 상세하고 구조화된 설명으로 변환할 수 있습니다.
* **워크플로우 로직 추론** — 모델을 사용해 워크플로우 파라미터를 분석하고 처리 단계를 제안하거나 다른 노드로 전달되는 구조화된 지침을 생성할 수 있습니다.
* **텍스트 기반 분석** — 텍스트 입력에서 정보를 추출하고, 콘텐츠를 분류하거나 구조화된 보고서를 생성할 수 있습니다.
* **사고 체인 추론** — 복잡한 다단계 작업에서 중간 과정의 추론을 거친 후 최종 결과를 생성하는 데 유리한 사고 모드를 활성화하세요.
## 이용 가능한 워크플로우
### Qwen 3.0: 텍스트 생성
JSON 파일을 다운로드하거나 템플릿 라이브러리에서 "Qwen 3.0 텍스트 생성"을 검색하세요.
Comfy Cloud에서 열기
이 워크플로우는 Qwen 3.0의 핵심 **텍스트 생성** 기능을 보여줍니다. 텍스트 프롬프트를 받아 모델의 내장된 추론 기능을 사용해 상세하고 구조화된 응답을 생성합니다.
**입력**:
* **텍스트 프롬프트** — 질문, 지시사항 또는 작업 설명
**주요 컨트롤**:
* **최대 길이** — 생성할 토큰의 최대 수 (기본값 256)
* **샘플링 모드** — 샘플링 켜기/끄기 및 온도, top-k, top-p, 반복 페널티, 시드 조정
* **사고 모드** — 최종 답변 전에 단계별 추론을 활성화
* **기본 템플릿 사용** — 모델용 내장 시스템 프롬프트 적용
**출력**:
* **생성된 텍스트** — 모델의 응답을 일반 텍스트 문자열로 반환
이 워크플로우는 서브그래프 노드를 사용해 모듈식 처리를 수행합니다. 서브그래프 문서를 확인하여 워크플로우를 맞춤화하고 확장하는 방법을 배워보세요.
## 모델 다운로드
Qwen 3.0 모델은 ComfyUI에서 텍스트 인코더로 로드됩니다. 모델 파일은 Qwen3.5와 공유되며, 하드웨어에 가장 적합한 변형을 다운로드하세요:
경량형, 약 4.5GB. 낮은 VRAM 환경과 빠른 다운로드에 최적입니다.
균형 잡힌 크기와 품질. 대부분의 소비자용 GPU에 권장됩니다.
가장 큰 변형, 약 19GB. 더 높은 품질의 출력을 제공하며, 더 많은 VRAM이 필요합니다.
다운로드한 `.safetensors` 파일을 다음 위치에 저장하세요:
```
📂 ComfyUI/
├── 📂 models/
│ └── 📂 text_encoders/
│ └── qwen3.5_4b_bf16.safetensors # 또는 2B / 9B 변형
```