Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions ko/changelog/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -922,14 +922,14 @@ translationFrom: changelog/index.mdx
**모델 호환성 및 수정 사항**
- **HunYuan 3D 2.0 지원**: 개선된 3D 모델 생성 워크플로우를 위한 호환성 문제를 해결했습니다.
- **EasyCache 개선**: 특정 모델 구성에 영향을 미쳤던 입출력 채널 불일치를 해결했습니다.
- 잠재적으로 유해한 기본 제공 맞춤형 노드 구현을 제거하여 블록 스왑 기능을 강화했습니다.
- 잠재적으로 유해한 기본 제공 커스텀 노드 구현을 제거하여 블록 스왑 기능을 강화했습니다.

**API 노드 개선 사항**
- **새로운 Gemini 모델 추가**: 텍스트 및 멀티모달 생성 워크플로우를 위한 AI 모델 옵션을 확장했습니다.
- 업데이트된 PR 템플릿과 Python 3.10 최소 버전 요구사항을 포함한 API 노드 개발 인프라를 개선했습니다.

**개발 및 인프라**
- 맞춤형 노드 개발 시 코드 품질을 높이기 위해 pylint 구성 강화했습니다.
- 커스텀 노드 개발 시 코드 품질을 높이기 위해 pylint 구성 강화했습니다.
- 보다 안정적인 업데이트를 위해 릴리스 자동화 및 배포 프로세스를 개선했습니다.

</Update>
Expand All @@ -948,7 +948,7 @@ translationFrom: changelog/index.mdx
- `/history` 및 `/queue` 엔드포인트에 `create_time` 필드 추가

**버그 수정**
- SingleStreamBlock/DoubleStreamBlock의 맞춤형 노드 가져오기 오류 수정(임시 해결)
- SingleStreamBlock/DoubleStreamBlock의 커스텀 노드 가져오기 오류 수정(임시 해결)
- Qwen ControlNet 회귀 문제 수정
- 오프로드 지원 및 안정성 개선을 통한 양자화된 연산 강화
- 모든 모델 간 RoPE 함수 구현 통합
Expand Down Expand Up @@ -996,7 +996,7 @@ translationFrom: changelog/index.mdx
**핵심 개선 사항**
- 종속성 인식 캐싱 시스템 강화로 루프와 함께 --cache-none 동작 해결
- 다차원 잠재 변수 지원 추가
- 맞춤형 노드 게시 서브그래프 엔드포인트 추가
- 커스텀 노드 게시 서브그래프 엔드포인트 추가

**업데이트 사항**
- 프론트엔드 버전 1.28.8로 업그레이드
Expand Down Expand Up @@ -1080,7 +1080,7 @@ translationFrom: changelog/index.mdx
- **광범위한 V3 변환**: 오디오 인코더, GITS, 차분 확산, 최적 단계, PAG, LT, IP2P, 형태학, torch 컴파일, EPS, Pixverse, TomeSD, 편집 모델, Rodin, Stable3D 노드 등 수많은 노드 카테고리를 V3 스키마로 이전하여 워크플로우의 호환성을 높였습니다.

**개발자 경험 개선**
- **코드 품질**: comfy_api_nodes 폴더에 pylint 지원을 추가하고 example_node.py를 V3 스키마로 업데이트하여 맞춤형 노드 개발을 더욱 일관되게 만들었습니다.
- **코드 품질**: comfy_api_nodes 폴더에 pylint 지원을 추가하고 example_node.py를 V3 스키마로 업데이트하여 커스텀 노드 개발을 더욱 일관되게 만들었습니다.
- **문서 업데이트**: Windows 사용자를 위한 야간 PyTorch 명령어를 포함한 AMD 설치 지침을 강화했습니다.

**프론트엔드 업데이트**
Expand Down Expand Up @@ -1421,7 +1421,7 @@ translationFrom: changelog/index.mdx
**워크플로우 개발 이점**
- **영상 워크플로우**: 영상 생성 파이프라인의 안정성과 성능을 개선했습니다.
- **메모리 관리**: 최적화된 메모리 사용 패턴으로 VRAM이 제한된 시스템에서도 더욱 복잡한 워크플로우를 구동할 수 있습니다.
- **API 신뢰성**: 핵심 API 개선을 통해 맞춤형 노드 개발의 기반이 더욱 안정적으로 되었습니다.
- **API 신뢰성**: 핵심 API 개선을 통해 커스텀 노드 개발의 기반이 더욱 안정적으로 되었습니다.
- **실행 유연성**: 새로운 부분 실행 기능을 통해 디버깅과 개발 과정을 더욱 효율적으로 수행할 수 있습니다.

</Update>
Expand Down Expand Up @@ -1525,7 +1525,7 @@ translationFrom: changelog/index.mdx

**개발자 경험 개선**
- **경고 시스템**: 일반적인 구성 문제를 잡아내기 위해 torch import 오류 경고를 추가했습니다.
- **템플릿 업데이트**: 맞춤형 노드 개발을 개선하기 위해 여러 템플릿 버전(0.1.36, 0.1.37, 0.1.39)을 업데이트했습니다.
- **템플릿 업데이트**: 커스텀 노드 개발을 개선하기 위해 여러 템플릿 버전(0.1.36, 0.1.37, 0.1.39)을 업데이트했습니다.
- **문서화**: fast_fp16_accumulation 문서를 강화했습니다.

</Update>
Expand Down Expand Up @@ -1602,7 +1602,7 @@ translationFrom: changelog/index.mdx
- **메모리 최적화**: Cosmos 모델에 대한 메모리 추정치 개선

**개발자 및 통합 기능**
- **SQLite 데이터베이스 지원**: 맞춤형 노드를 위한 데이터 관리 기능 강화
- **SQLite 데이터베이스 지원**: 커스텀 노드를 위한 데이터 관리 기능 강화
- **PyProject.toml 통합**: pyproject 파일에서 자동으로 웹 폴더 등록
- **프론트엔드 유연성**: semver 접미사 및 프리릴리즈 프론트엔드 버전 지원
- **토큰라이저 개선**: tokenizer_data와 함께 구성 가능한 min_length 설정
Expand Down
6 changes: 3 additions & 3 deletions ko/comfy-cli/getting-started.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ import InstallCli from "/snippets/install-comfycli.mdx";

이 도구는 두 가지 기능을 수행합니다:

1. **로컬 ComfyUI 설치 관리** — ComfyUI와 맞춤형 노드를 설치, 실행, 업데이트, 스냅샷 및 분석합니다.
1. **로컬 ComfyUI 설치 관리** — ComfyUI와 커스텀 노드를 설치, 실행, 업데이트, 스냅샷 및 분석합니다.
2. **호스팅된 파트너 노드 직접 호출** — Seedance, Nano Banana (Gemini), Grok, Flux, Ideogram, DALL·E, Recraft, Stability, Kling, Luma, Runway, Pika, Vidu, Hailuo, Moonvalley 등에서 이미지와 비디오를 단일 명령어로 생성합니다. 로컬 ComfyUI나 워크플로우 JSON이 필요하지 않습니다.

### CLI 설치
Expand Down Expand Up @@ -172,13 +172,13 @@ comfy generate dalle --prompt "수채화 고래" --json | jq '.data[0].url'

명령어, 플래그, 모델 별칭의 전체 목록은 [참조](/comfy-cli/reference)를 확인하세요.

## 맞춤형 노드 관리하기
## 커스텀 노드 관리하기

```bash
comfy node install <NODE_NAME>
```

맞춤형 노드 설치에는 `cm-cli`를 사용합니다. 자세한 내용은 [문서](https://github.com/Comfy-Org/ComfyUI-Manager/blob/main/docs/en/cm-cli.md)를 참고하세요.
커스텀 노드 설치에는 `cm-cli`를 사용합니다. 자세한 내용은 [문서](https://github.com/Comfy-Org/ComfyUI-Manager/blob/main/docs/en/cm-cli.md)를 참고하세요.

## 모델 관리하기

Expand Down
2 changes: 1 addition & 1 deletion ko/community/contributing.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,4 @@ translationFrom: community/contributing.mdx

우리는 모든 종류의 기여를 환영합니다. 저희가 지원하는 다양한 리포지토리를 [Github 조직](https://github.com/Comfy-Org)에서 확인해 보세요.

워크플로우를 공유하거나 [맞춤형 노드](/custom-nodes/overview)를 개발함으로써도 기여할 수 있습니다.
워크플로우를 공유하거나 [커스텀 노드](/custom-nodes/overview)를 개발함으로써도 기여할 수 있습니다.
2 changes: 1 addition & 1 deletion ko/custom-nodes/backend/expansion.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ translationFrom: custom-nodes/backend/expansion.mdx

## 노드 확장

일반적으로 노드가 실행되면 해당 실행 함수는 즉시 그 노드의 출력 결과를 반환합니다. "노드 확장"은 노드가 그래프 내에서 대신 자리 잡아야 할 새로운 하위 그래프를 반환하도록 하는 비교적 고급 기법입니다. 이 기법 덕분에 맞춤형 노드들이 루프를 구현할 수 있습니다.
일반적으로 노드가 실행되면 해당 실행 함수는 즉시 그 노드의 출력 결과를 반환합니다. "노드 확장"은 노드가 그래프 내에서 대신 자리 잡아야 할 새로운 하위 그래프를 반환하도록 하는 비교적 고급 기법입니다. 이 기법 덕분에 커스텀 노드들이 루프를 구현할 수 있습니다.

### 간단한 예제

Expand Down
18 changes: 9 additions & 9 deletions ko/custom-nodes/backend/interface.mdx
Original file line number Diff line number Diff line change
@@ -1,27 +1,27 @@
---
title: "코드 인터페이스"
description: "맞춤형 노드란 무엇이며, 어떻게 사용하나요?"
description: "커스텀 노드란 무엇이며, 어떻게 사용하나요?"
translationSourceHash: 67e14226
translationFrom: custom-nodes/backend/interface.mdx
---

## 개요

맞춤형 노드는 파이썬 코드와 일부 모델 가중치를 결합한 것입니다. 맞춤형 노드는 매우 강력하며, Comfy 커뮤니티가 자신만의 기능을 ComfyUI에 구축할 수 있도록 해줍니다.
커스텀 노드는 파이썬 코드와 일부 모델 가중치를 결합한 것입니다. 커스텀 노드는 매우 강력하며, Comfy 커뮤니티가 자신만의 기능을 ComfyUI에 구축할 수 있도록 해줍니다.

코드를 읽는 것을 선호한다면 저장소의 [예제](https://github.com/Comfy-Org/ComfyUI/blob/master/custom_nodes/example_node.py.example)를 확인해 보세요. 그렇지 않다면 아래에서 Comfy의 내장 노드 중 하나를 살펴보겠습니다.

## 인터페이스

ComfyUI의 내장 [체크포인트 로드](https://github.com/Comfy-Org/ComfyUI/blob/master/nodes.py#L529C7-L529C29) 노드를 통해 맞춤형 노드의 인터페이스를 살펴보겠습니다. 이 노드는 체크포인트 파일을 로드합니다.
ComfyUI의 내장 [체크포인트 로드](https://github.com/Comfy-Org/ComfyUI/blob/master/nodes.py#L529C7-L529C29) 노드를 통해 커스텀 노드의 인터페이스를 살펴보겠습니다. 이 노드는 체크포인트 파일을 로드합니다.

### 함수

모든 맞춤형 노드는 다음 메서드를 구현할 수 있습니다.
모든 커스텀 노드는 다음 메서드를 구현할 수 있습니다.

#### INPUT_TYPES

이것은 맞춤형 노드가 입력으로 받을 수 있는 매개변수를 정의합니다.
이것은 커스텀 노드가 입력으로 받을 수 있는 매개변수를 정의합니다.

```python
@classmethod
Expand Down Expand Up @@ -73,7 +73,7 @@ CATEGORY = "loaders"

#### FUNCTION

맞춤형 노드 클래스에서 호출할 파이썬 함수의 이름입니다.
커스텀 노드 클래스에서 호출할 파이썬 함수의 이름입니다.

LoadCheckpointSimple의 경우, 함수는 다음과 같이 정의됩니다:

Expand Down Expand Up @@ -106,15 +106,15 @@ CATEGORY = "loaders"

#### WEB_DIRECTORY

맞춤형 노드는 맞춤형 UI를 가질 수 있습니다.
커스텀 노드는 맞춤형 UI를 가질 수 있습니다.

이 속성은 웹 디렉토리를 설정합니다. 해당 디렉토리에 있는 모든 `.js` 파일은 프론트엔드 확장으로 로드됩니다.

맞춤형 노드는 `WEB_DIRECTORY/docs` 폴더에 마크다운 문서화를 포함할 수도 있습니다. 노드에 풍부한 문서화를 추가하는 방법에 대한 자세한 내용은 [도움말 페이지](/custom-nodes/help_page) 섹션을 참조하세요.
커스텀 노드는 `WEB_DIRECTORY/docs` 폴더에 마크다운 문서화를 포함할 수도 있습니다. 노드에 풍부한 문서화를 추가하는 방법에 대한 자세한 내용은 [도움말 페이지](/custom-nodes/help_page) 섹션을 참조하세요.

#### NODE_CLASS_MAPPINGS

내보낼 모든 노드와 그 클래스 이름을 포함한 딕셔너리입니다. 클래스 이름은 고유해야 합니다. 이는 하나의 "맞춤형 노드"에 여러 노드를 정의하고 모두 함께 내보낼 수 있음을 의미합니다.
내보낼 모든 노드와 그 클래스 이름을 포함한 딕셔너리입니다. 클래스 이름은 고유해야 합니다. 이는 하나의 "커스텀 노드"에 여러 노드를 정의하고 모두 함께 내보낼 수 있음을 의미합니다.

```python
NODE_CLASS_MAPPINGS = {
Expand Down
10 changes: 5 additions & 5 deletions ko/custom-nodes/backend/lifecycle.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,16 +4,16 @@ translationSourceHash: cf134c1a
translationFrom: custom-nodes/backend/lifecycle.mdx
---

## Comfy가 맞춤형 노드를 로드하는 방법
## Comfy가 커스텀 노드를 로드하는 방법

Comfy가 시작되면, `custom_nodes` 디렉터리를 파이썬 모듈로 스캔하고 이를 로드하려고 시도합니다.
모듈이 `NODE_CLASS_MAPPINGS`를 내보내면, 이는 맞춤형 노드로 처리됩니다.
모듈이 `NODE_CLASS_MAPPINGS`를 내보내면, 이는 커스텀 노드로 처리됩니다.
<Tip>파이썬 모듈은 `__init__.py` 파일을 포함한 디렉터리입니다.
모듈은 `__init__.py`에 정의된 `__all__` 속성에 나열된 내용을 내보냅니다.</Tip>

### __init__.py

`__init__.py`는 Comfy가 모듈을 가져오려고 할 때 실행됩니다. 모듈이 맞춤형 노드 정의를 포함하고 있다고 인식되려면, `NODE_CLASS_MAPPINGS`를 내보내야 합니다. 만약 그렇게 하고(그리고 가져오기 과정에서 문제가 없다면), 모듈에 정의된 노드들은 Comfy에서 사용 가능해집니다. 코드에 오류가 있으면 Comfy는 계속 진행하지만, 해당 모듈이 로드되지 않았다고 보고합니다. 그러니 파이썬 콘솔을 확인하세요!
`__init__.py`는 Comfy가 모듈을 가져오려고 할 때 실행됩니다. 모듈이 커스텀 노드 정의를 포함하고 있다고 인식되려면, `NODE_CLASS_MAPPINGS`를 내보내야 합니다. 만약 그렇게 하고(그리고 가져오기 과정에서 문제가 없다면), 모듈에 정의된 노드들은 Comfy에서 사용 가능해집니다. 코드에 오류가 있으면 Comfy는 계속 진행하지만, 해당 모듈이 로드되지 않았다고 보고합니다. 그러니 파이썬 콘솔을 확인하세요!

아주 간단한 `__init__.py` 파일은 다음과 같을 것입니다:
```python
Expand All @@ -24,15 +24,15 @@ __all__ = ["NODE_CLASS_MAPPINGS"]

#### NODE_CLASS_MAPPINGS

`NODE_CLASS_MAPPINGS`는 맞춤형 노드 이름(Comfy 설치 내에서 고유)을 해당 노드 클래스로 매핑하는 `dict`여야 합니다.
`NODE_CLASS_MAPPINGS`는 커스텀 노드 이름(Comfy 설치 내에서 고유)을 해당 노드 클래스로 매핑하는 `dict`여야 합니다.

#### NODE_DISPLAY_NAME_MAPPINGS

`__init__.py`는 또한 동일한 고유 이름을 노드의 표시 이름으로 매핑하는 `NODE_DISPLAY_NAME_MAPPINGS`를 내보낼 수 있습니다. 만약 `NODE_DISPLAY_NAME_MAPPINGS`가 제공되지 않으면, Comfy는 고유 이름을 표시 이름으로 사용합니다.

#### WEB_DIRECTORY

클라이언트 측 코드를 배포하는 경우, 자바스크립트 파일들이 위치할 모듈 상대 경로를 내보내야 합니다. 일반적으로 이러한 파일들을 맞춤형 노드의 하위 디렉터리인 `js`에 두는 것이 관례입니다.
클라이언트 측 코드를 배포하는 경우, 자바스크립트 파일들이 위치할 모듈 상대 경로를 내보내야 합니다. 일반적으로 이러한 파일들을 커스텀 노드의 하위 디렉터리인 `js`에 두는 것이 관례입니다.
<Tip>*오직* `.js` 파일만 제공됩니다; `.css`나 다른 유형의 파일은 이런 방식으로 배포할 수 없습니다</Tip>

<Warning>이전 버전의 Comfy에서는 `__init__.py`를 통해 자바스크립트 파일을 메인 Comfy 웹 하위 디렉터리로 복사해야 했습니다. 아직도 그런 코드를 볼 수 있을 것입니다. 하지만 그럴 필요는 없습니다.</Warning>
6 changes: 3 additions & 3 deletions ko/custom-nodes/backend/node-replacement.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ translationSourceHash: 2f5ad97d
translationFrom: custom-nodes/backend/node-replacement.mdx
---

노드 교체 API를 통해 맞춤형 노드 개발자는 더 이상 사용되지 않는 노드에서 최신 equivalent로의 마이그레이션 경로를 정의할 수 있습니다. 노드를 업데이트하거나 이름을 변경하면 사용자가 워크플로우를 자동으로 업그레이드할 수 있습니다.
노드 교체 API를 통해 커스텀 노드 개발자는 더 이상 사용되지 않는 노드에서 최신 equivalent로의 마이그레이션 경로를 정의할 수 있습니다. 노드를 업데이트하거나 이름을 변경하면 사용자가 워크플로우를 자동으로 업그레이드할 수 있습니다.

## 언제 사용하나요

Expand All @@ -16,7 +16,7 @@ translationFrom: custom-nodes/backend/node-replacement.mdx

## 교체를 어디에 등록하나요

확장 프로그램의 `on_load` 라이프사이클 훅 동안 교체를 등록하세요. 맞춤형 노드 패키지에 전용 파일(예: `node_replacements.py`)을 생성하세요:
확장 프로그램의 `on_load` 라이프사이클 훅 동안 교체를 등록하세요. 커스텀 노드 패키지에 전용 파일(예: `node_replacements.py`)을 생성하세요:

```
my_custom_nodes/
Expand All @@ -27,7 +27,7 @@ my_custom_nodes/

## 전체 예제

다음은 맞춤형 노드 패키지에서 노드 교체를 구성하는 방법을 보여주는 전체 예제입니다:
다음은 커스텀 노드 패키지에서 노드 교체를 구성하는 방법을 보여주는 전체 예제입니다:

```python
# node_replacements.py
Expand Down
8 changes: 4 additions & 4 deletions ko/custom-nodes/backend/server_overview.mdx
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
title: "속성"
description: "맞춤형 노드의 속성"
description: "커스텀 노드의 속성"
translationSourceHash: a4e248ba
translationFrom: custom-nodes/backend/server_overview.mdx
---

### 간단한 예제

다음은 이미지 반전 노드의 코드로, 맞춤형 노드 개발의 핵심 개념을 살펴볼 수 있습니다.
다음은 이미지 반전 노드의 코드로, 커스텀 노드 개발의 핵심 개념을 살펴볼 수 있습니다.

```python
class InvertImageNode:
Expand All @@ -29,7 +29,7 @@ class InvertImageNode:

### 주요 속성

모든 맞춤형 노드는 Python 클래스이며, 다음과 같은 주요 속성을 갖습니다:
모든 커스텀 노드는 Python 클래스이며, 다음과 같은 주요 속성을 갖습니다:

#### INPUT_TYPES

Expand Down Expand Up @@ -68,7 +68,7 @@ Comfy의 훌륭한 기능 중 하나는 출력을 캐시하고, 이전 실행과

본질적으로 이는 어떤 노드가 출력을 생성하는지 식별하고(특히 이미지 미리보기 및 이미지 저장 노드는 항상 실행됨), 이후 역방향으로 작업하여 마지막 실행 이후 변경되었을 수 있는 데이터를 제공하는 노드를 식별합니다.

맞춤형 노드의 두 가지 선택적 기능이 이 과정을 돕습니다.
커스텀 노드의 두 가지 선택적 기능이 이 과정을 돕습니다.

#### OUTPUT_NODE

Expand Down
Loading
Loading