diff --git a/ko/changelog/index.mdx b/ko/changelog/index.mdx index 1bf62a786..79d70c303 100644 --- a/ko/changelog/index.mdx +++ b/ko/changelog/index.mdx @@ -922,14 +922,14 @@ translationFrom: changelog/index.mdx **모델 호환성 및 수정 사항** - **HunYuan 3D 2.0 지원**: 개선된 3D 모델 생성 워크플로우를 위한 호환성 문제를 해결했습니다. - **EasyCache 개선**: 특정 모델 구성에 영향을 미쳤던 입출력 채널 불일치를 해결했습니다. -- 잠재적으로 유해한 기본 제공 맞춤형 노드 구현을 제거하여 블록 스왑 기능을 강화했습니다. +- 잠재적으로 유해한 기본 제공 커스텀 노드 구현을 제거하여 블록 스왑 기능을 강화했습니다. **API 노드 개선 사항** - **새로운 Gemini 모델 추가**: 텍스트 및 멀티모달 생성 워크플로우를 위한 AI 모델 옵션을 확장했습니다. - 업데이트된 PR 템플릿과 Python 3.10 최소 버전 요구사항을 포함한 API 노드 개발 인프라를 개선했습니다. **개발 및 인프라** -- 맞춤형 노드 개발 시 코드 품질을 높이기 위해 pylint 구성 강화했습니다. +- 커스텀 노드 개발 시 코드 품질을 높이기 위해 pylint 구성 강화했습니다. - 보다 안정적인 업데이트를 위해 릴리스 자동화 및 배포 프로세스를 개선했습니다. @@ -948,7 +948,7 @@ translationFrom: changelog/index.mdx - `/history` 및 `/queue` 엔드포인트에 `create_time` 필드 추가 **버그 수정** -- SingleStreamBlock/DoubleStreamBlock의 맞춤형 노드 가져오기 오류 수정(임시 해결) +- SingleStreamBlock/DoubleStreamBlock의 커스텀 노드 가져오기 오류 수정(임시 해결) - Qwen ControlNet 회귀 문제 수정 - 오프로드 지원 및 안정성 개선을 통한 양자화된 연산 강화 - 모든 모델 간 RoPE 함수 구현 통합 @@ -996,7 +996,7 @@ translationFrom: changelog/index.mdx **핵심 개선 사항** - 종속성 인식 캐싱 시스템 강화로 루프와 함께 --cache-none 동작 해결 - 다차원 잠재 변수 지원 추가 -- 맞춤형 노드 게시 서브그래프 엔드포인트 추가 +- 커스텀 노드 게시 서브그래프 엔드포인트 추가 **업데이트 사항** - 프론트엔드 버전 1.28.8로 업그레이드 @@ -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 설치 지침을 강화했습니다. **프론트엔드 업데이트** @@ -1421,7 +1421,7 @@ translationFrom: changelog/index.mdx **워크플로우 개발 이점** - **영상 워크플로우**: 영상 생성 파이프라인의 안정성과 성능을 개선했습니다. - **메모리 관리**: 최적화된 메모리 사용 패턴으로 VRAM이 제한된 시스템에서도 더욱 복잡한 워크플로우를 구동할 수 있습니다. -- **API 신뢰성**: 핵심 API 개선을 통해 맞춤형 노드 개발의 기반이 더욱 안정적으로 되었습니다. +- **API 신뢰성**: 핵심 API 개선을 통해 커스텀 노드 개발의 기반이 더욱 안정적으로 되었습니다. - **실행 유연성**: 새로운 부분 실행 기능을 통해 디버깅과 개발 과정을 더욱 효율적으로 수행할 수 있습니다. @@ -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 문서를 강화했습니다. @@ -1602,7 +1602,7 @@ translationFrom: changelog/index.mdx - **메모리 최적화**: Cosmos 모델에 대한 메모리 추정치 개선 **개발자 및 통합 기능** -- **SQLite 데이터베이스 지원**: 맞춤형 노드를 위한 데이터 관리 기능 강화 +- **SQLite 데이터베이스 지원**: 커스텀 노드를 위한 데이터 관리 기능 강화 - **PyProject.toml 통합**: pyproject 파일에서 자동으로 웹 폴더 등록 - **프론트엔드 유연성**: semver 접미사 및 프리릴리즈 프론트엔드 버전 지원 - **토큰라이저 개선**: tokenizer_data와 함께 구성 가능한 min_length 설정 diff --git a/ko/comfy-cli/getting-started.mdx b/ko/comfy-cli/getting-started.mdx index 384bd3242..14d799a8e 100644 --- a/ko/comfy-cli/getting-started.mdx +++ b/ko/comfy-cli/getting-started.mdx @@ -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 설치 @@ -172,13 +172,13 @@ comfy generate dalle --prompt "수채화 고래" --json | jq '.data[0].url' 명령어, 플래그, 모델 별칭의 전체 목록은 [참조](/comfy-cli/reference)를 확인하세요. -## 맞춤형 노드 관리하기 +## 커스텀 노드 관리하기 ```bash comfy node install ``` -맞춤형 노드 설치에는 `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)를 참고하세요. ## 모델 관리하기 diff --git a/ko/community/contributing.mdx b/ko/community/contributing.mdx index 195bc41e1..df958226a 100644 --- a/ko/community/contributing.mdx +++ b/ko/community/contributing.mdx @@ -8,4 +8,4 @@ translationFrom: community/contributing.mdx 우리는 모든 종류의 기여를 환영합니다. 저희가 지원하는 다양한 리포지토리를 [Github 조직](https://github.com/Comfy-Org)에서 확인해 보세요. -워크플로우를 공유하거나 [맞춤형 노드](/custom-nodes/overview)를 개발함으로써도 기여할 수 있습니다. \ No newline at end of file +워크플로우를 공유하거나 [커스텀 노드](/custom-nodes/overview)를 개발함으로써도 기여할 수 있습니다. \ No newline at end of file diff --git a/ko/custom-nodes/backend/expansion.mdx b/ko/custom-nodes/backend/expansion.mdx index eff14adb8..ad95d6ead 100644 --- a/ko/custom-nodes/backend/expansion.mdx +++ b/ko/custom-nodes/backend/expansion.mdx @@ -6,7 +6,7 @@ translationFrom: custom-nodes/backend/expansion.mdx ## 노드 확장 -일반적으로 노드가 실행되면 해당 실행 함수는 즉시 그 노드의 출력 결과를 반환합니다. "노드 확장"은 노드가 그래프 내에서 대신 자리 잡아야 할 새로운 하위 그래프를 반환하도록 하는 비교적 고급 기법입니다. 이 기법 덕분에 맞춤형 노드들이 루프를 구현할 수 있습니다. +일반적으로 노드가 실행되면 해당 실행 함수는 즉시 그 노드의 출력 결과를 반환합니다. "노드 확장"은 노드가 그래프 내에서 대신 자리 잡아야 할 새로운 하위 그래프를 반환하도록 하는 비교적 고급 기법입니다. 이 기법 덕분에 커스텀 노드들이 루프를 구현할 수 있습니다. ### 간단한 예제 diff --git a/ko/custom-nodes/backend/interface.mdx b/ko/custom-nodes/backend/interface.mdx index 07cef0a9b..b30747bef 100644 --- a/ko/custom-nodes/backend/interface.mdx +++ b/ko/custom-nodes/backend/interface.mdx @@ -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 @@ -73,7 +73,7 @@ CATEGORY = "loaders" #### FUNCTION -맞춤형 노드 클래스에서 호출할 파이썬 함수의 이름입니다. +커스텀 노드 클래스에서 호출할 파이썬 함수의 이름입니다. LoadCheckpointSimple의 경우, 함수는 다음과 같이 정의됩니다: @@ -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 = { diff --git a/ko/custom-nodes/backend/lifecycle.mdx b/ko/custom-nodes/backend/lifecycle.mdx index eb0cfd3ce..95b4b31c1 100644 --- a/ko/custom-nodes/backend/lifecycle.mdx +++ b/ko/custom-nodes/backend/lifecycle.mdx @@ -4,16 +4,16 @@ translationSourceHash: cf134c1a translationFrom: custom-nodes/backend/lifecycle.mdx --- -## Comfy가 맞춤형 노드를 로드하는 방법 +## Comfy가 커스텀 노드를 로드하는 방법 Comfy가 시작되면, `custom_nodes` 디렉터리를 파이썬 모듈로 스캔하고 이를 로드하려고 시도합니다. -모듈이 `NODE_CLASS_MAPPINGS`를 내보내면, 이는 맞춤형 노드로 처리됩니다. +모듈이 `NODE_CLASS_MAPPINGS`를 내보내면, 이는 커스텀 노드로 처리됩니다. 파이썬 모듈은 `__init__.py` 파일을 포함한 디렉터리입니다. 모듈은 `__init__.py`에 정의된 `__all__` 속성에 나열된 내용을 내보냅니다. ### __init__.py -`__init__.py`는 Comfy가 모듈을 가져오려고 할 때 실행됩니다. 모듈이 맞춤형 노드 정의를 포함하고 있다고 인식되려면, `NODE_CLASS_MAPPINGS`를 내보내야 합니다. 만약 그렇게 하고(그리고 가져오기 과정에서 문제가 없다면), 모듈에 정의된 노드들은 Comfy에서 사용 가능해집니다. 코드에 오류가 있으면 Comfy는 계속 진행하지만, 해당 모듈이 로드되지 않았다고 보고합니다. 그러니 파이썬 콘솔을 확인하세요! +`__init__.py`는 Comfy가 모듈을 가져오려고 할 때 실행됩니다. 모듈이 커스텀 노드 정의를 포함하고 있다고 인식되려면, `NODE_CLASS_MAPPINGS`를 내보내야 합니다. 만약 그렇게 하고(그리고 가져오기 과정에서 문제가 없다면), 모듈에 정의된 노드들은 Comfy에서 사용 가능해집니다. 코드에 오류가 있으면 Comfy는 계속 진행하지만, 해당 모듈이 로드되지 않았다고 보고합니다. 그러니 파이썬 콘솔을 확인하세요! 아주 간단한 `__init__.py` 파일은 다음과 같을 것입니다: ```python @@ -24,7 +24,7 @@ __all__ = ["NODE_CLASS_MAPPINGS"] #### NODE_CLASS_MAPPINGS -`NODE_CLASS_MAPPINGS`는 맞춤형 노드 이름(Comfy 설치 내에서 고유)을 해당 노드 클래스로 매핑하는 `dict`여야 합니다. +`NODE_CLASS_MAPPINGS`는 커스텀 노드 이름(Comfy 설치 내에서 고유)을 해당 노드 클래스로 매핑하는 `dict`여야 합니다. #### NODE_DISPLAY_NAME_MAPPINGS @@ -32,7 +32,7 @@ __all__ = ["NODE_CLASS_MAPPINGS"] #### WEB_DIRECTORY -클라이언트 측 코드를 배포하는 경우, 자바스크립트 파일들이 위치할 모듈 상대 경로를 내보내야 합니다. 일반적으로 이러한 파일들을 맞춤형 노드의 하위 디렉터리인 `js`에 두는 것이 관례입니다. +클라이언트 측 코드를 배포하는 경우, 자바스크립트 파일들이 위치할 모듈 상대 경로를 내보내야 합니다. 일반적으로 이러한 파일들을 커스텀 노드의 하위 디렉터리인 `js`에 두는 것이 관례입니다. *오직* `.js` 파일만 제공됩니다; `.css`나 다른 유형의 파일은 이런 방식으로 배포할 수 없습니다 이전 버전의 Comfy에서는 `__init__.py`를 통해 자바스크립트 파일을 메인 Comfy 웹 하위 디렉터리로 복사해야 했습니다. 아직도 그런 코드를 볼 수 있을 것입니다. 하지만 그럴 필요는 없습니다. \ No newline at end of file diff --git a/ko/custom-nodes/backend/node-replacement.mdx b/ko/custom-nodes/backend/node-replacement.mdx index d885b27c9..b02c1f825 100644 --- a/ko/custom-nodes/backend/node-replacement.mdx +++ b/ko/custom-nodes/backend/node-replacement.mdx @@ -5,7 +5,7 @@ translationSourceHash: 2f5ad97d translationFrom: custom-nodes/backend/node-replacement.mdx --- -노드 교체 API를 통해 맞춤형 노드 개발자는 더 이상 사용되지 않는 노드에서 최신 equivalent로의 마이그레이션 경로를 정의할 수 있습니다. 노드를 업데이트하거나 이름을 변경하면 사용자가 워크플로우를 자동으로 업그레이드할 수 있습니다. +노드 교체 API를 통해 커스텀 노드 개발자는 더 이상 사용되지 않는 노드에서 최신 equivalent로의 마이그레이션 경로를 정의할 수 있습니다. 노드를 업데이트하거나 이름을 변경하면 사용자가 워크플로우를 자동으로 업그레이드할 수 있습니다. ## 언제 사용하나요 @@ -16,7 +16,7 @@ translationFrom: custom-nodes/backend/node-replacement.mdx ## 교체를 어디에 등록하나요 -확장 프로그램의 `on_load` 라이프사이클 훅 동안 교체를 등록하세요. 맞춤형 노드 패키지에 전용 파일(예: `node_replacements.py`)을 생성하세요: +확장 프로그램의 `on_load` 라이프사이클 훅 동안 교체를 등록하세요. 커스텀 노드 패키지에 전용 파일(예: `node_replacements.py`)을 생성하세요: ``` my_custom_nodes/ @@ -27,7 +27,7 @@ my_custom_nodes/ ## 전체 예제 -다음은 맞춤형 노드 패키지에서 노드 교체를 구성하는 방법을 보여주는 전체 예제입니다: +다음은 커스텀 노드 패키지에서 노드 교체를 구성하는 방법을 보여주는 전체 예제입니다: ```python # node_replacements.py diff --git a/ko/custom-nodes/backend/server_overview.mdx b/ko/custom-nodes/backend/server_overview.mdx index dd58c8c41..980d036aa 100644 --- a/ko/custom-nodes/backend/server_overview.mdx +++ b/ko/custom-nodes/backend/server_overview.mdx @@ -1,13 +1,13 @@ --- title: "속성" -description: "맞춤형 노드의 속성" +description: "커스텀 노드의 속성" translationSourceHash: a4e248ba translationFrom: custom-nodes/backend/server_overview.mdx --- ### 간단한 예제 -다음은 이미지 반전 노드의 코드로, 맞춤형 노드 개발의 핵심 개념을 살펴볼 수 있습니다. +다음은 이미지 반전 노드의 코드로, 커스텀 노드 개발의 핵심 개념을 살펴볼 수 있습니다. ```python class InvertImageNode: @@ -29,7 +29,7 @@ class InvertImageNode: ### 주요 속성 -모든 맞춤형 노드는 Python 클래스이며, 다음과 같은 주요 속성을 갖습니다: +모든 커스텀 노드는 Python 클래스이며, 다음과 같은 주요 속성을 갖습니다: #### INPUT_TYPES @@ -68,7 +68,7 @@ Comfy의 훌륭한 기능 중 하나는 출력을 캐시하고, 이전 실행과 본질적으로 이는 어떤 노드가 출력을 생성하는지 식별하고(특히 이미지 미리보기 및 이미지 저장 노드는 항상 실행됨), 이후 역방향으로 작업하여 마지막 실행 이후 변경되었을 수 있는 데이터를 제공하는 노드를 식별합니다. -맞춤형 노드의 두 가지 선택적 기능이 이 과정을 돕습니다. +커스텀 노드의 두 가지 선택적 기능이 이 과정을 돕습니다. #### OUTPUT_NODE diff --git a/ko/custom-nodes/help_page.mdx b/ko/custom-nodes/help_page.mdx index ceb092125..94828b4cb 100644 --- a/ko/custom-nodes/help_page.mdx +++ b/ko/custom-nodes/help_page.mdx @@ -1,14 +1,14 @@ --- -title: "ComfyUI 맞춤형 노드에 노드 문서 추가하기" +title: "ComfyUI 커스텀 노드에 노드 문서 추가하기" sidebarTitle: "노드 문서" -description: "맞춤형 노드에 풍부한 문서를 생성하는 방법" +description: "커스텀 노드에 풍부한 문서를 생성하는 방법" translationSourceHash: 4c3c0517 translationFrom: custom-nodes/help_page.mdx --- ## 마크다운을 이용한 노드 문서 작성 -맞춤형 노드는 일반적인 노드 설명 대신 UI에 표시될 풍부한 마크다운 형식의 문서를 포함할 수 있습니다. 이를 통해 사용자들은 노드의 기능, 매개변수 및 사용 예제에 대한 상세한 정보를 얻을 수 있습니다. +커스텀 노드는 일반적인 노드 설명 대신 UI에 표시될 풍부한 마크다운 형식의 문서를 포함할 수 있습니다. 이를 통해 사용자들은 노드의 기능, 매개변수 및 사용 예제에 대한 상세한 정보를 얻을 수 있습니다. 노드 정의에서 이미 각 매개변수에 대한 도구팁을 추가했다면, 이 기본 정보는 노드 문서 패널을 통해 바로 접근할 수 있습니다. @@ -16,7 +16,7 @@ translationFrom: custom-nodes/help_page.mdx ## 설정 -맞춤형 노드 또는 다국어 지원 문서를 추가하려면: +커스텀 노드 또는 다국어 지원 문서를 추가하려면: 1. `WEB_DIRECTORY` 내부에 `docs` 폴더를 생성하세요. 2. 노드 이름을 따서 마크다운 파일을 추가하세요(노드 이름은 노드를 등록하는 데 사용되는 `NODE_CLASS_MAPPINGS` 딕셔너리의 키입니다): @@ -53,7 +53,7 @@ my-custom-node/ ## 예제 마크다운 파일 ```markdown -# 나만의 맞춤형 노드 +# 나만의 커스텀 노드 이 노드는 고급 알고리즘을 사용해 이미지를 처리합니다. diff --git a/ko/custom-nodes/i18n.mdx b/ko/custom-nodes/i18n.mdx index a4904c952..7c8bba0fb 100644 --- a/ko/custom-nodes/i18n.mdx +++ b/ko/custom-nodes/i18n.mdx @@ -1,6 +1,6 @@ --- -title: "ComfyUI 맞춤형 노드 i18n 지원" -description: "ComfyUI 맞춤형 노드에 다국어 지원을 추가하는 방법 알아보기" +title: "ComfyUI 커스텀 노드 i18n 지원" +description: "ComfyUI 커스텀 노드에 다국어 지원을 추가하는 방법 알아보기" sidebarTitle: "i18n 지원" translationSourceHash: af21fb42 translationFrom: custom-nodes/i18n.mdx @@ -13,11 +13,11 @@ import SupportedLanguages from '/snippets/interface/supported-languages.mdx' -맞춤형 노드 i18n 데모: [comfyui-wiki/ComfyUI-i18n-demo](https://github.com/comfyui-wiki/ComfyUI-i18n-demo) +커스텀 노드 i18n 데모: [comfyui-wiki/ComfyUI-i18n-demo](https://github.com/comfyui-wiki/ComfyUI-i18n-demo) ## 디렉토리 구조 -맞춤형 노드 아래에 `locales` 폴더를 생성하고, 여러 유형의 번역 파일을 지원하세요: +커스텀 노드 아래에 `locales` 폴더를 생성하고, 여러 유형의 번역 파일을 지원하세요: ```bash your_custom_node/ @@ -145,7 +145,7 @@ class I18nTextProcessor: ## 메뉴 설정 -예를 들어, i18n-demo 맞춤형 노드에서는 다음과 같은 두 가지 메뉴 설정을 등록했습니다: +예를 들어, i18n-demo 커스텀 노드에서는 다음과 같은 두 가지 메뉴 설정을 등록했습니다: ```javascript app.registerExtension({ name: "I18nDemo", diff --git a/ko/custom-nodes/js/javascript_hooks.mdx b/ko/custom-nodes/js/javascript_hooks.mdx index e53a86045..25aa8b354 100644 --- a/ko/custom-nodes/js/javascript_hooks.mdx +++ b/ko/custom-nodes/js/javascript_hooks.mdx @@ -32,7 +32,7 @@ async beforeRegisterNodeDef(nodeType, nodeData, app) 이 메서드는 등록된 각 확장 프로그램에서 _모든_ 노드 유형에 대해 호출되며, 해당 확장 프로그램에서 추가한 노드만이 아니라 다른 노드에도 적용됩니다. -일반적인 관용구는 `nodeType.ComfyClass`를 확인하는 것입니다. 이는 해당 노드에 대응하는 파이썬 클래스 이름을 담고 있으며, 노드를 수정해야 하는지 여부를 판단하는 데 사용됩니다. 종종 이는 추가한 맞춤 노드를 수정하는 것을 의미하지만, 때로는 다른 노드의 동작을 수정해야 할 수도 있고(또는 다른 맞춤 노드가 당신의 노드를 수정할 수도 있음!), 이 경우 상호 운용성을 보장하기 위해 신중을 기해야 합니다. +일반적인 관용구는 `nodeType.ComfyClass`를 확인하는 것입니다. 이는 해당 노드에 대응하는 파이썬 클래스 이름을 담고 있으며, 노드를 수정해야 하는지 여부를 판단하는 데 사용됩니다. 종종 이는 추가한 커스텀 노드를 수정하는 것을 의미하지만, 때로는 다른 노드의 동작을 수정해야 할 수도 있고(또는 다른 커스텀 노드가 당신의 노드를 수정할 수도 있음!), 이 경우 상호 운용성을 보장하기 위해 신중을 기해야 합니다. 다른 확장 프로그램에서도 노드를 수정할 수 있으므로 최대한 적은 가정을 바탕으로 코드를 작성하도록 노력하세요. 그리고 서로 잘 협력하도록 하세요—가능한 한 변경 사항을 격리하세요. @@ -76,7 +76,7 @@ async init() ``` Comfy 웹페이지가 로드될 때(또는 다시 로드될 때) 호출됩니다. 이 호출은 그래프 객체가 생성된 후, 하지만 아직 노드가 등록되거나 생성되기 전에 이루어집니다. 앱이나 그래프(LiteGraph 객체)의 메서드를 하이잭해 핵심 Comfy 동작을 수정하는 데 사용할 수 있습니다. 이 내용은 [Comfy 객체](./javascript_objects_and_hijacking)에서 더 자세히 다룹니다. -큰 권한을 가진 만큼 큰 책임이 따릅니다. 핵심 동작을 하이잭하면 다른 맞춤 노드나 향후 Comfy 업데이트와 호환되지 않을 가능성이 높아집니다 +큰 권한을 가진 만큼 큰 책임이 따릅니다. 핵심 동작을 하이잭하면 다른 커스텀 노드나 향후 Comfy 업데이트와 호환되지 않을 가능성이 높아집니다 #### setup() diff --git a/ko/custom-nodes/js/javascript_objects_and_hijacking.mdx b/ko/custom-nodes/js/javascript_objects_and_hijacking.mdx index 04af40035..0963c58a8 100644 --- a/ko/custom-nodes/js/javascript_objects_and_hijacking.mdx +++ b/ko/custom-nodes/js/javascript_objects_and_hijacking.mdx @@ -208,7 +208,7 @@ Comfy에서 `큐 프롬프트` 버튼을 누르면 `app.graphToPrompt()` 메서 `prompt.output`는 그래프의 각 노드의 `node_id`에서 두 가지 속성을 가진 객체로 매핑됩니다. -- `prompt.output[node_id].class_type`, 파이썬 코드에서 정의된 맞춤형 노드 클래스의 고유한 이름 +- `prompt.output[node_id].class_type`, 파이썬 코드에서 정의된 커스텀 노드 클래스의 고유한 이름 - `prompt.output[node_id].inputs`, 각 입력(또는 위젯)의 값을 입력 이름에서 다음으로 매핑한 객체로 포함합니다: - 선택된 값이 위젯인 경우, 또는 - 입력에 연결된 링크가 있는 경우 (`upstream_node_id`, `upstream_node_output_slot`)를 포함한 배열, 또는 diff --git a/ko/development/comfyui-server/api-key-integration.mdx b/ko/development/comfyui-server/api-key-integration.mdx index 0b26a98b8..309fa093c 100644 --- a/ko/development/comfyui-server/api-key-integration.mdx +++ b/ko/development/comfyui-server/api-key-integration.mdx @@ -11,7 +11,7 @@ translationFrom: development/comfyui-server/api-key-integration.mdx 이는 다음과 같은 요소를 결합한 워크플로우를 생성할 수 있음을 의미합니다: - 로컬 OS 모델 -- 맞춤형 노드 커뮤니티의 도구 +- 커스텀 노드 커뮤니티의 도구 - 인기 있는 유료 모델 그런 다음 Comfy 웹서버 API에 단순히 프롬프트를 보내 모든 작업을 함께 실행하며, 모든 오케스트레이션을 처리하도록 할 수 있습니다. @@ -25,7 +25,7 @@ translationFrom: development/comfyui-server/api-key-integration.mdx - 충분한 계정 크레딧 - **중요:** 이 페이지는 워크플로우에서 유료 파트너 노드에 접근하는 데 사용되는 **ComfyUI 계정 API 키**를 설명합니다. 만약 맞춤형 노드를 레지스트리에 게시하려는 경우, [노드 게시하기](/ko/registry/publishing)를 참조하세요. + **중요:** 이 페이지는 워크플로우에서 유료 파트너 노드에 접근하는 데 사용되는 **ComfyUI 계정 API 키**를 설명합니다. 만약 커스텀 노드를 레지스트리에 게시하려는 경우, [노드 게시하기](/ko/registry/publishing)를 참조하세요. ComfyUI 계정 API 키를 사용해 유료 파트너 노드를 호출하려면 먼저 [ComfyUI 플랫폼](https://platform.comfy.org/login)에서 계정을 등록하고 [API 키를 생성](/ko/development/api-development/getting-an-api-key)해야 합니다. diff --git a/ko/development/comfyui-server/comms_routes.mdx b/ko/development/comfyui-server/comms_routes.mdx index 916efc2fc..528dc2b98 100644 --- a/ko/development/comfyui-server/comms_routes.mdx +++ b/ko/development/comfyui-server/comms_routes.mdx @@ -23,7 +23,7 @@ translationFrom: development/comfyui-server/comms_routes.mdx | `/features` | get | 서버 기능 및 역량 조회 | | `/models` | get | 사용 가능한 모델 유형 목록 조회 | | `/models/{folder}` | get | 특정 폴더의 모델 조회 | -| `/workflow_templates` | get | 맞춤 노드 모듈과 관련 템플릿 워크플로우 맵 조회 | +| `/workflow_templates` | get | 커스텀 노드 모듈과 관련 템플릿 워크플로우 맵 조회 | | `/upload/image` | post | 이미지 업로드 | | `/upload/mask` | post | 마스크 업로드 | | `/view` | get | 이미지 보기. 다양한 옵션 참조, `server.py`의 `@routes.get("/view")` 확인 | diff --git a/ko/development/comfyui-server/execution_model_inversion_guide.mdx b/ko/development/comfyui-server/execution_model_inversion_guide.mdx index 151b9a1ca..11579bc56 100644 --- a/ko/development/comfyui-server/execution_model_inversion_guide.mdx +++ b/ko/development/comfyui-server/execution_model_inversion_guide.mdx @@ -5,7 +5,7 @@ translationSourceHash: 9b968a87 translationFrom: development/comfyui-server/execution_model_inversion_guide.mdx --- -[PR #2666](https://github.com/Comfy-Org/ComfyUI/pull/2666)는 실행 모델을 뒤에서부터 앞쪽으로 진행하는 재귀적 모델에서 앞에서부터 뒤로 진행하는 위상 정렬 방식으로 반전시킵니다. 대부분의 맞춤형 노드는 기존처럼 "그냥 작동"할 것으로 예상되지만, 이 페이지는 맞춤형 노드 제작자들이 *고장날 수 있는* 부분들을 안내하기 위한 것입니다. +[PR #2666](https://github.com/Comfy-Org/ComfyUI/pull/2666)는 실행 모델을 뒤에서부터 앞쪽으로 진행하는 재귀적 모델에서 앞에서부터 뒤로 진행하는 위상 정렬 방식으로 반전시킵니다. 대부분의 커스텀 노드는 기존처럼 "그냥 작동"할 것으로 예상되지만, 이 페이지는 커스텀 노드 제작자들이 *고장날 수 있는* 부분들을 안내하기 위한 것입니다. ## 중단되는 변경사항 ### 몽키 패치 @@ -14,9 +14,9 @@ translationFrom: development/comfyui-server/execution_model_inversion_guide.mdx ### 선택적 입력 검증 -이 PR 이전에는, 일련의 `"required"` 입력을 통해서만 출력에 연결된 노드만 실제로 검증되었습니다. 만약 맞춤형 노드가 오직 `"optional"` 입력에만 연결되어 있었다면, 이전에는 검증 실패를 확인하지 못했을 것입니다. +이 PR 이전에는, 일련의 `"required"` 입력을 통해서만 출력에 연결된 노드만 실제로 검증되었습니다. 만약 커스텀 노드가 오직 `"optional"` 입력에만 연결되어 있었다면, 이전에는 검증 실패를 확인하지 못했을 것입니다. -노드의 출력이 이미 `"required"` 입력에 연결될 수 있다면, 이 섹션의 내용이 적용될 가능성은 낮습니다. 주로 맞춤형 타입을 사용하고 오직 `"optional"` 입력만 사용하는 맞춤형 노드 제작자들에게 해당됩니다. +노드의 출력이 이미 `"required"` 입력에 연결될 수 있다면, 이 섹션의 내용이 적용될 가능성은 낮습니다. 주로 맞춤형 타입을 사용하고 오직 `"optional"` 입력만 사용하는 커스텀 노드 제작자들에게 해당됩니다. 다음과 같은 사항들이 검증 실패를 일으킬 수 있으며, 권장 해결 방법도 함께 제공합니다: diff --git a/ko/development/core-concepts/custom-nodes.mdx b/ko/development/core-concepts/custom-nodes.mdx index f8105069f..de7fbeb69 100644 --- a/ko/development/core-concepts/custom-nodes.mdx +++ b/ko/development/core-concepts/custom-nodes.mdx @@ -1,59 +1,59 @@ --- -title: "맞춤형 노드" -description: "ComfyUI에서 맞춤형 노드 설치, 종속성 활성화, 업데이트, 비활성화, 제거에 대해 알아보세요" +title: "커스텀 노드" +description: "ComfyUI에서 커스텀 노드 설치, 종속성 활성화, 업데이트, 비활성화, 제거에 대해 알아보세요" icon: "window-maximize" translationSourceHash: 1e63acbc translationFrom: development/core-concepts/custom-nodes.mdx --- -## 맞춤형 노드 소개 +## 커스텀 노드 소개 ComfyUI를 설치하면 내장 노드가 많이 포함되어 있는 것을 알게 됩니다. 이러한 기본 노드는 **Comfy Core** 노드라고 하며, ComfyUI에서 공식적으로 유지 관리합니다. -또한 ComfyUI 커뮤니티의 여러 제작자가 만든 다양한 [**맞춤형 노드**](https://registry.comfy.org)가 있습니다. 이 맞춤형 노드는 ComfyUI에 광범위한 기능을 제공하여 그 능력과 기능의 경계를 크게 확장합니다. +또한 ComfyUI 커뮤니티의 여러 제작자가 만든 다양한 [**커스텀 노드**](https://registry.comfy.org)가 있습니다. 이 커스텀 노드는 ComfyUI에 광범위한 기능을 제공하여 그 능력과 기능의 경계를 크게 확장합니다. -이 가이드에서는 설치, 업데이트, 비활성화, 제거, 종속성 설치 등 맞춤형 노드와 관련된 여러 작업을 다룹니다. +이 가이드에서는 설치, 업데이트, 비활성화, 제거, 종속성 설치 등 커스텀 노드와 관련된 여러 작업을 다룹니다. -누구나 ComfyUI용 맞춤형 확장을 개발하여 다른 사람들과 공유할 수 있습니다. 많은 커뮤니티 맞춤형 노드를 [여기](https://registry.comfy.org)에서 확인할 수 있습니다. 자신만의 맞춤형 노드를 개발하려면 아래 섹션을 방문하여 시작하세요. +누구나 ComfyUI용 맞춤형 확장을 개발하여 다른 사람들과 공유할 수 있습니다. 많은 커뮤니티 커스텀 노드를 [여기](https://registry.comfy.org)에서 확인할 수 있습니다. 자신만의 커스텀 노드를 개발하려면 아래 섹션을 방문하여 시작하세요. - - 맞춤형 노드 개발을 시작하는 방법 알아보기 + + 커스텀 노드 개발을 시작하는 방법 알아보기 -## 맞춤형 노드 관리 +## 커스텀 노드 관리 이 섹션에서는 다음을 다룹니다: -- 맞춤형 노드 설치 +- 커스텀 노드 설치 - 노드 종속성 설치 -- 맞춤형 노드 버전 관리 -- 맞춤형 노드 제거 -- 맞춤형 노드 일시 비활성화 -- 맞춤형 노드 종속성 충돌 처리 +- 커스텀 노드 버전 관리 +- 커스텀 노드 제거 +- 커스텀 노드 일시 비활성화 +- 커스텀 노드 종속성 충돌 처리 -### 1. 맞춤형 노드 설치 +### 1. 커스텀 노드 설치 -현재 ComfyUI는 다음과 같은 여러 방법을 통해 맞춤형 노드 설치를 지원합니다. +현재 ComfyUI는 다음과 같은 여러 방법을 통해 커스텀 노드 설치를 지원합니다. - [ComfyUI Manager를 통한 설치(권장)](#install-via-comfyui-manager) - Git을 통한 설치 - 수동 설치 -**ComfyUI Manager**를 통해 맞춤형 노드를 설치하는 것을 권장합니다. 이는 ComfyUI 맞춤형 노드 생태계에서 매우 중요한 도구입니다. 검색, 설치, 업데이트, 비활성화, 제거 등 맞춤형 노드 관리를 간단하게 만들어 줍니다. ComfyUI Manager에서 설치하려는 노드를 검색하고 설치를 클릭하기만 하면 됩니다. +**ComfyUI Manager**를 통해 커스텀 노드를 설치하는 것을 권장합니다. 이는 ComfyUI 커스텀 노드 생태계에서 매우 중요한 도구입니다. 검색, 설치, 업데이트, 비활성화, 제거 등 커스텀 노드 관리를 간단하게 만들어 줍니다. ComfyUI Manager에서 설치하려는 노드를 검색하고 설치를 클릭하기만 하면 됩니다. -그러나 현재 모든 맞춤형 노드는 GitHub에 저장되어 있으므로, GitHub에 정상적으로 접근할 수 없는 지역을 위해 이 가이드에서 다양한 맞춤형 노드 설치 방법에 대한 자세한 안내를 제공합니다. +그러나 현재 모든 커스텀 노드는 GitHub에 저장되어 있으므로, GitHub에 정상적으로 접근할 수 없는 지역을 위해 이 가이드에서 다양한 커스텀 노드 설치 방법에 대한 자세한 안내를 제공합니다. 또한 플러그인 관리에 **ComfyUI Manager** 사용을 권장하므로 이 도구를 플러그인 관리에 사용하는 것이 좋습니다. 소스 코드는 [여기](https://github.com/Comfy-Org/ComfyUI-Manager)에서 확인할 수 있습니다. -따라서 이 문서에서는 ComfyUI Manager 설치를 맞춤형 노드 설치 예제로 사용하고, 관련 소개 섹션에서 노드 관리에 어떻게 사용하는지 보충 설명합니다. +따라서 이 문서에서는 ComfyUI Manager 설치를 커스텀 노드 설치 예제로 사용하고, 관련 소개 섹션에서 노드 관리에 어떻게 사용하는지 보충 설명합니다. -ComfyUI Manager는 매우 풍부한 기능을 갖추고 있으므로, 별도의 문서로 ComfyUI Manager 설치 장을 소개합니다. 아래 링크를 방문하여 ComfyUI Manager로 맞춤형 노드를 설치하는 방법을 알아보세요. +ComfyUI Manager는 매우 풍부한 기능을 갖추고 있으므로, 별도의 문서로 ComfyUI Manager 설치 장을 소개합니다. 아래 링크를 방문하여 ComfyUI Manager로 커스텀 노드를 설치하는 방법을 알아보세요. - - ComfyUI Manager를 사용하여 맞춤형 노드 설치 방법 알아보기 + + ComfyUI Manager를 사용하여 커스텀 노드 설치 방법 알아보기 @@ -81,9 +81,9 @@ ComfyUI Desktop 버전의 경우 아래와 같이 Desktop 터미널을 사용하 - + -Git 설치를 완료한 후에는 맞춤형 노드의 저장소 주소가 필요합니다. 여기서는 ComfyUI-Manager 저장소 주소를 예로 사용합니다. +Git 설치를 완료한 후에는 커스텀 노드의 저장소 주소가 필요합니다. 여기서는 ComfyUI-Manager 저장소 주소를 예로 사용합니다. ```bash https://github.com/Comfy-Org/ComfyUI-Manager @@ -91,7 +91,7 @@ https://github.com/Comfy-Org/ComfyUI-Manager GitHub에 원활히 접근할 수 없는 지역의 경우, 다른 코드 호스팅 서비스 웹사이트를 사용하여 해당 저장소를 포크한 후 그 저장소 주소로 노드 설치를 완료할 수 있습니다 (예: gitee 등). -먼저 ComfyUI 맞춤형 노드 디렉터리로 이동해야 합니다. ComfyUI portable 버전을 예로 들면, 폴더 위치가 `D:\ComfyUI_windows_portable`일 경우 `D:\ComfyUI_windows_portable\ComfyUI\custom_nodes`에서 맞춤형 노드 폴더를 찾을 수 있습니다. 먼저 `cd` 명령을 사용하여 해당 디렉터리로 이동해야 합니다. +먼저 ComfyUI 커스텀 노드 디렉터리로 이동해야 합니다. ComfyUI portable 버전을 예로 들면, 폴더 위치가 `D:\ComfyUI_windows_portable`일 경우 `D:\ComfyUI_windows_portable\ComfyUI\custom_nodes`에서 커스텀 노드 폴더를 찾을 수 있습니다. 먼저 `cd` 명령을 사용하여 해당 디렉터리로 이동해야 합니다. ```bash cd D:\ComfyUI_windows_portable\ComfyUI\custom_nodes @@ -105,9 +105,9 @@ git clone https://github.com/Comfy-Org/ComfyUI-Manager 모든 것이 순조롭게 진행되면 다음과 유사한 출력이 표시됩니다. -![Git을 통한 맞춤형 노드 설치](/images/concepts/custom_nodes/install_custom_nodes_by_git.jpg) +![Git을 통한 커스텀 노드 설치](/images/concepts/custom_nodes/install_custom_nodes_by_git.jpg) -이는 맞춤형 노드 코드를 성공적으로 복제했음을 의미합니다. 다음으로 해당 종속성을 설치해야 합니다. +이는 커스텀 노드 코드를 성공적으로 복제했음을 의미합니다. 다음으로 해당 종속성을 설치해야 합니다. [노드 종속성 설치](#installing-node-dependencies) 섹션의 지침을 참조하여 종속성을 설치하세요. @@ -124,21 +124,21 @@ git clone https://github.com/Comfy-Org/ComfyUI-Manager - + 수동 설치를 위해서는 먼저 해당 노드 코드를 다운로드한 후 적절한 디렉터리에 압축을 풀어야 합니다. ![노드 코드 다운로드](/images/concepts/custom_nodes/download_zip.jpg) -해당 맞춤형 노드 저장소 페이지를 방문하세요: +해당 커스텀 노드 저장소 페이지를 방문하세요: 1. 'Code' 버튼을 클릭합니다. 2. 그런 다음 'Download ZIP' 버튼을 클릭하여 ZIP 패키지를 다운로드합니다. 3. ZIP 패키지의 압축을 풉니다. - + -위 단계에서 압축을 푼 코드를 ComfyUI 맞춤형 노드 디렉터리로 복사합니다. ComfyUI portable 버전을 예로 들면, 폴더 위치가 `D:\ComfyUI_windows_portable`일 경우 `D:\ComfyUI_windows_portable\ComfyUI\custom_nodes`에서 맞춤형 노드 폴더를 찾을 수 있습니다. 위 단계에서 압축을 푼 코드를 해당 디렉터리로 복사합니다. +위 단계에서 압축을 푼 코드를 ComfyUI 커스텀 노드 디렉터리로 복사합니다. ComfyUI portable 버전을 예로 들면, 폴더 위치가 `D:\ComfyUI_windows_portable`일 경우 `D:\ComfyUI_windows_portable\ComfyUI\custom_nodes`에서 커스텀 노드 폴더를 찾을 수 있습니다. 위 단계에서 압축을 푼 코드를 해당 디렉터리로 복사합니다. @@ -151,19 +151,19 @@ git clone https://github.com/Comfy-Org/ComfyUI-Manager ### 2. 노드 종속성 설치 -맞춤형 노드는 모두 관련 종속성 설치가 필요합니다. 예를 들어 ComfyUI-Manager의 경우 [requirements.txt](https://github.com/Comfy-Org/ComfyUI-Manager/blob/main/requirements.txt) 파일을 방문하여 종속성 패키지 요구 사항을 확인할 수 있습니다. +커스텀 노드는 모두 관련 종속성 설치가 필요합니다. 예를 들어 ComfyUI-Manager의 경우 [requirements.txt](https://github.com/Comfy-Org/ComfyUI-Manager/blob/main/requirements.txt) 파일을 방문하여 종속성 패키지 요구 사항을 확인할 수 있습니다. -앞선 단계에서는 맞춤형 노드 코드만 로컬에 복제했을 뿐 해당 종속성을 설치하지 않았으므로, 이제 해당 종속성을 설치해야 합니다. +앞선 단계에서는 커스텀 노드 코드만 로컬에 복제했을 뿐 해당 종속성을 설치하지 않았으므로, 이제 해당 종속성을 설치해야 합니다. -실제로 ComfyUI-Manager를 사용하여 플러그인을 설치하면 ComfyUI Manager가 자동으로 종속성 설치를 완료해 줍니다. 플러그인 설치 후 ComfyUI를 다시 시작하기만 하면 됩니다. 이것이 바로 ComfyUI Manager를 사용하여 맞춤형 노드를 설치하는 것을 강력히 권장하는 이유입니다. +실제로 ComfyUI-Manager를 사용하여 플러그인을 설치하면 ComfyUI Manager가 자동으로 종속성 설치를 완료해 줍니다. 플러그인 설치 후 ComfyUI를 다시 시작하기만 하면 됩니다. 이것이 바로 ComfyUI Manager를 사용하여 커스텀 노드를 설치하는 것을 강력히 권장하는 이유입니다. -하지만 일부 상황에서 ComfyUI Manager를 사용하여 맞춤형 노드를 원활하게 설치하지 못할 수도 있으므로, 이보다 더 자세한 종속성 설치 안내를 제공합니다. +하지만 일부 상황에서 ComfyUI Manager를 사용하여 커스텀 노드를 원활하게 설치하지 못할 수도 있으므로, 이보다 더 자세한 종속성 설치 안내를 제공합니다. [종속성](/ko/development/core-concepts/dependencies) 장에서 ComfyUI의 종속성 관련 내용을 소개했습니다. ComfyUI는 **Python** 기반 프로젝트이며, ComfyUI 실행을 위해 독립적인 **Python** 런타임 환경을 구축했습니다. 모든 관련 종속성은 이 독립적인 **Python** 런타임 환경에 설치해야 합니다. -시스템 레벨 터미널에서 `pip install -r requirements.txt`를 직접 실행하면 해당 종속성이 시스템 레벨 **Python** 환경에 설치될 수 있으며, 이로 인해 ComfyUI 환경에서는 여전히 종속성이 누락되어 해당 맞춤형 노드가 정상적으로 실행되지 않을 수 있습니다. +시스템 레벨 터미널에서 `pip install -r requirements.txt`를 직접 실행하면 해당 종속성이 시스템 레벨 **Python** 환경에 설치될 수 있으며, 이로 인해 ComfyUI 환경에서는 여전히 종속성이 누락되어 해당 커스텀 노드가 정상적으로 실행되지 않을 수 있습니다. 따라서 다음으로는 ComfyUI의 독립적인 Python 런타임 환경을 사용하여 종속성을 설치해야 합니다. @@ -186,14 +186,14 @@ ComfyUI Portable 버전의 경우, `\ComfyUI_windows_portable\python_embeded` ```bash python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Manager\requirements.txt ``` -물론 ComfyUI-Manager 대신 실제로 설치한 맞춤형 노드 이름으로 바꿀 수 있지만, 해당 노드 디렉터리에 `requirements.txt` 파일이 존재하는지 확인하세요. +물론 ComfyUI-Manager 대신 실제로 설치한 커스텀 노드 이름으로 바꿀 수 있지만, 해당 노드 디렉터리에 `requirements.txt` 파일이 존재하는지 확인하세요. -ComfyUI Desktop 버전은 이미 설치 과정에서 ComfyUI-Manager와 그 종속성이 설치되어 있으며, 이 가이드에서도 ComfyUI Manager를 맞춤형 노드 설치 예제로 사용하므로, Desktop 버전에서는 실제로 ComfyUI Manager 종속성 설치를 수행할 필요가 없습니다. -예상치 못한 문제가 없다면, ComfyUI Manager를 사용하여 맞춤형 노드를 설치하는 것을 권장하므로 수동으로 종속성을 설치할 필요가 없습니다. +ComfyUI Desktop 버전은 이미 설치 과정에서 ComfyUI-Manager와 그 종속성이 설치되어 있으며, 이 가이드에서도 ComfyUI Manager를 커스텀 노드 설치 예제로 사용하므로, Desktop 버전에서는 실제로 ComfyUI Manager 종속성 설치를 수행할 필요가 없습니다. +예상치 못한 문제가 없다면, ComfyUI Manager를 사용하여 커스텀 노드를 설치하는 것을 권장하므로 수동으로 종속성을 설치할 필요가 없습니다. ![ComfyUI Desktop 터미널](/images/concepts/custom_nodes/desktop_terminal.png) @@ -215,9 +215,9 @@ pip install -r .\custom_nodes\<해당_맞춤형_노드_이름>\requirements.txt -### 맞춤형 노드 버전 관리 +### 커스텀 노드 버전 관리 -맞춤형 노드 버전 관리는 실제로 Git 버전 관리에 기반합니다. Git을 통해 노드 버전을 관리할 수 있지만, ComfyUI Manager는 이미 이 버전 관리 기능을 매우 잘 통합했습니다. 이렇게 편리한 도구를 제공해 주신 [@Dr.Lt.Data](https://github.com/ltdrdata)님께 깊이 감사드립니다. +커스텀 노드 버전 관리는 실제로 Git 버전 관리에 기반합니다. Git을 통해 노드 버전을 관리할 수 있지만, ComfyUI Manager는 이미 이 버전 관리 기능을 매우 잘 통합했습니다. 이렇게 편리한 도구를 제공해 주신 [@Dr.Lt.Data](https://github.com/ltdrdata)님께 깊이 감사드립니다. 이 섹션에서는 이 두 가지 다른 플러그인 버전 관리 방법을 설명드리지만, ZIP 패키지를 사용하여 수동 설치한 경우에는 해당 git 버전 기록 정보가 사라지므로 버전 관리를 수행할 수 없습니다. @@ -231,7 +231,7 @@ pip install -r .\custom_nodes\<해당_맞춤형_노드_이름>\requirements.txt 아래와 같이 해당 작업을 수행하여 ComfyUI Manager 인터페이스로 들어갑니다. - + 필터를 사용하여 설치된 노드 패키지를 필터링한 후 해당 노드 관리를 수행할 수 있습니다. @@ -279,7 +279,7 @@ git checkout <커밋_해시> -버전 전환 후 해당 맞춤형 노드 패키지의 종속성이 변경될 수 있으므로 해당 노드의 종속성을 다시 설치해야 합니다. [노드 종속성 설치](#2-installing-node-dependencies) 섹션의 지침을 참조하여 해당 환경으로 이동하여 설치하세요. +버전 전환 후 해당 커스텀 노드 패키지의 종속성이 변경될 수 있으므로 해당 노드의 종속성을 다시 설치해야 합니다. [노드 종속성 설치](#2-installing-node-dependencies) 섹션의 지침을 참조하여 해당 환경으로 이동하여 설치하세요. @@ -288,15 +288,15 @@ git checkout <커밋_해시> -### 맞춤형 노드 제거 +### 커스텀 노드 제거 업데이트 예정 -### 맞춤형 노드 일시적 비활성화 +### 커스텀 노드 일시적 비활성화 업데이트 예정 -### 맞춤형 노드 종속성 충돌 +### 커스텀 노드 종속성 충돌 업데이트 예정 @@ -331,10 +331,10 @@ git clone https://github.com/Comfy-Org/ComfyUI-Manager.git manager를 설치한 후 manager에서 누락된 노드를 감지할 수 있습니다. ![ComfyUI Manager 인터페이스](/images/concepts/core-concepts_nodes_manager.png) -## 맞춤형 노드 개발 +## 커스텀 노드 개발 -개발 능력이 있다면 아래 문서부터 시작하여 맞춤형 노드 개발을 시작하는 방법을 알아보세요. +개발 능력이 있다면 아래 문서부터 시작하여 커스텀 노드 개발을 시작하는 방법을 알아보세요. - - 맞춤형 노드 개발을 시작하는 방법 알아보기 + + 커스텀 노드 개발을 시작하는 방법 알아보기 \ No newline at end of file diff --git a/ko/development/core-concepts/dependencies.mdx b/ko/development/core-concepts/dependencies.mdx index d9b26080d..b8aa19880 100644 --- a/ko/development/core-concepts/dependencies.mdx +++ b/ko/development/core-concepts/dependencies.mdx @@ -12,13 +12,13 @@ description: "ComfyUI에서 자산 및 소프트웨어 종속성 이해하기" ## 워크플로우 파일은 다른 파일에 의존합니다 -우리는 종종 커뮤니티에서 다양한 워크플로우 파일을 얻지만, 로드한 후 바로 실행할 수 없는 경우가 많습니다. 이는 워크플로우 파일이 워크플로우 자체 외에도 미디어 자산 입력, 모델, 맞춤형 노드, 관련 파이썬 종속성 등 다른 파일들에 의존하기 때문입니다. +우리는 종종 커뮤니티에서 다양한 워크플로우 파일을 얻지만, 로드한 후 바로 실행할 수 없는 경우가 많습니다. 이는 워크플로우 파일이 워크플로우 자체 외에도 미디어 자산 입력, 모델, 커스텀 노드, 관련 파이썬 종속성 등 다른 파일들에 의존하기 때문입니다. ComfyUI 워크플로우는 관련된 모든 종속성이 충족되어야만 정상적으로 실행됩니다. ComfyUI 워크플로우 종속성은 주로 다음과 같은 카테고리로 나뉩니다: - 자산 (오디오, 비디오, 이미지 및 기타 입력을 포함한 미디어 파일) -- 맞춤형 노드 +- 커스텀 노드 - 파이썬 종속성 - 모델 (Stable Diffusion 모델 등) @@ -28,9 +28,9 @@ AI 모델은 **_자산_**의 한 예입니다. 미디어 제작에서 자산이 ComfyUI도 같은 방식으로 작동합니다. 워크플로우는 필요한 모든 자산이 발견되고 로드되어야만 실행될 수 있습니다. 생성 AI 모델, 이미지, 동영상, 사운드 등은 워크플로우가 의존할 수 있는 자산의 몇 가지 예시입니다. 따라서 이를 **_의존 자산_** 또는 **_자산 종속성_**이라고 합니다. -## 맞춤형 노드 +## 커스텀 노드 -맞춤형 노드는 ComfyUI의 기능을 확장하는 중요한 구성 요소입니다. 커뮤니티에서 만들어진 것으로, 설치하여 워크플로우에 새로운 기능을 추가할 수 있습니다. +커스텀 노드는 ComfyUI의 기능을 확장하는 중요한 구성 요소입니다. 커뮤니티에서 만들어진 것으로, 설치하여 워크플로우에 새로운 기능을 추가할 수 있습니다. ## 파이썬 종속성 @@ -84,13 +84,13 @@ pip install -r requirements.txt 또한 ComfyUI의 프론트엔드 [ComfyUI_frontend](https://github.com/Comfy-Org/ComfyUI_frontend)는 현재 별도의 프로젝트로 관리되고 있습니다. 우리는 해당 버전이 안정화된 후 `comfyui-frontend-package` 종속성 버전을 업데이트합니다. 다른 프론트엔드 버전으로 전환하려면 [여기](https://pypi.org/project/comfyui-frontend-package/#history)에서 버전 정보를 확인할 수 있습니다. -### 맞춤형 노드 종속성 +### 커스텀 노드 종속성 -ComfyUI 커뮤니티의 많은 저자들의 노력 덕분에 우리는 서로 다른 맞춤형 노드를 사용해 ComfyUI의 기능을 확장하고 놀라운 창의력을 발휘할 수 있습니다. +ComfyUI 커뮤니티의 많은 저자들의 노력 덕분에 우리는 서로 다른 커스텀 노드를 사용해 ComfyUI의 기능을 확장하고 놀라운 창의력을 발휘할 수 있습니다. -일반적으로 각 맞춤형 노드는 고유한 종속성과 별도의 `requirements.txt` 파일을 가지고 있습니다. [ComfyUI Manager](https://github.com/Comfy-Org/ComfyUI-Manager)를 사용해 맞춤형 노드를 설치하면 ComfyUI Manager가 일반적으로 해당 종속성을 자동으로 설치해줍니다. +일반적으로 각 커스텀 노드는 고유한 종속성과 별도의 `requirements.txt` 파일을 가지고 있습니다. [ComfyUI Manager](https://github.com/Comfy-Org/ComfyUI-Manager)를 사용해 커스텀 노드를 설치하면 ComfyUI Manager가 일반적으로 해당 종속성을 자동으로 설치해줍니다. -하지만 수동으로 종속성을 설치해야 하는 경우도 있습니다. 현재 모든 맞춤형 노드는 `ComfyUI/custom_nodes` 디렉토리에 설치됩니다. +하지만 수동으로 종속성을 설치해야 하는 경우도 있습니다. 현재 모든 커스텀 노드는 `ComfyUI/custom_nodes` 디렉토리에 설치됩니다. ComfyUI 파이썬 환경에서 해당 플러그인 디렉토리로 이동한 후 `pip install -r requirements.txt`를 실행해 종속성을 설치해야 합니다. @@ -102,11 +102,11 @@ python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\=2.29.0`)을 요구해 두 버전의 요구사항을 동시에 만족할 수 없습니다. @@ -114,26 +114,26 @@ ComfyUI를 사용하다 보면 종속성 충돌 문제가 자주 발생합니다 2. 환경 오염 -맞춤형 노드 종속성을 설치하는 과정에서 다른 플러그인들이 이미 설치한 라이브러리의 버전을 덮어쓸 수 있습니다. 예를 들어 여러 플러그인이 `PyTorch`에 의존하지만 서로 다른 CUDA 버전을 요구한다면, 이후 설치된 플러그인이 기존 환경을 깨뜨릴 수 있습니다. +커스텀 노드 종속성을 설치하는 과정에서 다른 플러그인들이 이미 설치한 라이브러리의 버전을 덮어쓸 수 있습니다. 예를 들어 여러 플러그인이 `PyTorch`에 의존하지만 서로 다른 CUDA 버전을 요구한다면, 이후 설치된 플러그인이 기존 환경을 깨뜨릴 수 있습니다. **해결 방법**: - 파이썬 가상환경에서 특정 버전의 종속성을 수동으로 설치해 이런 문제를 해결할 수 있습니다. - 또는 서로 다른 플러그인마다 별도의 파이썬 가상환경을 만들어 이런 문제를 해결할 수 있습니다. - 플러그인을 하나씩 설치하면서 매번 ComfyUI를 재시작해 종속성 충돌 여부를 관찰해보세요. -3. 맞춤형 노드 종속성 버전과 ComfyUI 종속성 버전 간의 호환성 문제 +3. 커스텀 노드 종속성 버전과 ComfyUI 종속성 버전 간의 호환성 문제 -이런 종류의 종속성 충돌은 해결하기 더 어려울 수 있으며, ComfyUI를 업그레이드하거나 다운그레이드하거나 맞춤형 노드의 종속성 버전을 변경해 문제를 해결해야 할 수 있습니다. +이런 종류의 종속성 충돌은 해결하기 더 어려울 수 있으며, ComfyUI를 업그레이드하거나 다운그레이드하거나 커스텀 노드의 종속성 버전을 변경해 문제를 해결해야 할 수 있습니다. -**해결 방법**: 이런 종류의 종속성 충돌은 해결하기 더 어려울 수 있으며, ComfyUI를 업그레이드하거나 다운그레이드하거나 맞춤형 노드의 종속성 버전을 변경해 문제를 해결해야 할 수 있습니다. +**해결 방법**: 이런 종류의 종속성 충돌은 해결하기 더 어려울 수 있으며, ComfyUI를 업그레이드하거나 다운그레이드하거나 커스텀 노드의 종속성 버전을 변경해 문제를 해결해야 할 수 있습니다. ## 모델 -모델은 ComfyUI의 중요한 자산 종속성입니다. 다양한 맞춤형 노드와 워크플로우는 특정 모델을 중심으로 구축되며, 예를 들어 Stable Diffusion 시리즈, Flux 시리즈, Ltxv 등이 있습니다. +모델은 ComfyUI의 중요한 자산 종속성입니다. 다양한 커스텀 노드와 워크플로우는 특정 모델을 중심으로 구축되며, 예를 들어 Stable Diffusion 시리즈, Flux 시리즈, Ltxv 등이 있습니다. 이 모델들은 ComfyUI로 창작하는 데 필수적인 기반이므로 우리가 사용하는 모델이 제대로 이용 가능하도록 보장해야 합니다. 일반적으로 우리의 모델은 `ComfyUI/models/` 하위 디렉토리에 저장됩니다. 물론, [extra_model_paths.yaml](https://github.com/Comfy-Org/ComfyUI/blob/master/extra_model_paths.yaml.example)을 템플릿을 수정해 추가 모델 경로를 ComfyUI가 인식하도록 만들 수도 있습니다. 이를 통해 여러 ComfyUI 인스턴스가 동일한 모델 라이브러리를 공유해 디스크 사용량을 줄일 수 있습니다. ## 소프트웨어 -ComfyUI와 같은 고급 애플리케이션은 **_소프트웨어 종속성_**도 가지고 있습니다. 이는 애플리케이션이 실행되기 위해 필요한 프로그래밍 코드와 데이터 라이브러리입니다. 맞춤형 노드는 소프트웨어 종속성의 예입니다. 더욱 근본적인 차원에서는 파이썬 프로그래밍 환경이 ComfyUI의 궁극적인 종속성입니다. 특정 버전의 ComfyUI를 실행하려면 올바른 버전의 파이썬이 필요합니다. 파이썬, ComfyUI, 맞춤형 노드의 업데이트는 모두 **ComfyUI Manager** 창에서 처리할 수 있습니다. +ComfyUI와 같은 고급 애플리케이션은 **_소프트웨어 종속성_**도 가지고 있습니다. 이는 애플리케이션이 실행되기 위해 필요한 프로그래밍 코드와 데이터 라이브러리입니다. 커스텀 노드는 소프트웨어 종속성의 예입니다. 더욱 근본적인 차원에서는 파이썬 프로그래밍 환경이 ComfyUI의 궁극적인 종속성입니다. 특정 버전의 ComfyUI를 실행하려면 올바른 버전의 파이썬이 필요합니다. 파이썬, ComfyUI, 커스텀 노드의 업데이트는 모두 **ComfyUI Manager** 창에서 처리할 수 있습니다. -![ComfyUI 맞춤형 노드 관리자](/images/concepts/core-concepts_dependecies_custom-nodes-manager.png) \ No newline at end of file +![ComfyUI 커스텀 노드 관리자](/images/concepts/core-concepts_dependecies_custom-nodes-manager.png) \ No newline at end of file diff --git a/ko/development/core-concepts/models.mdx b/ko/development/core-concepts/models.mdx index 704738bcc..7e61e3d5c 100644 --- a/ko/development/core-concepts/models.mdx +++ b/ko/development/core-concepts/models.mdx @@ -16,7 +16,7 @@ ComfyUI에서 **모델**이란 실제로 워크플로우를 실행하는 가중 - **내장된 1차 지원 범위는 의도적으로 제한되어 있지만**, ComfyUI와 오픈소스 생태계가 발전함에 따라 점차 늘어납니다. 모델이 일급 지원을 받으면 보통 **[워크플로우 템플릿 라이브러리](/interface/features/template)**에 새로운 항목이 추가되며, 예상되는 그래프와 모델 조합이 표시됩니다. - **모든 체크포인트나 가중치 파일이 바로 사용 가능한 것은 아닙니다.** 기본적으로 지원되는 모델과 그에 따른 일반적인 가중치 파일의 경우, ComfyUI를 **최신 상태로 유지**( /installation/update_comfyui)하고 **템플릿 라이브러리**( /interface/features/template)에 해당 워크플로우가 있는지 확인한 후에야 파일이 잘못된 위치에 있는 것이 아니라는 것을 확신할 수 있습니다. -- **다수의 다른 모델은 커뮤니티의 맞춤형 노드를 통해 활성화됩니다.** 경로, 로더 노드, 그래프 레이아웃은 이 페이지의 일반적인 `ComfyUI/models/` 안내와 다를 수 있으므로 **각 프로젝트의 README나 문서를 반드시 따르세요**. ComfyUI는 매우 확장성이 뛰어나므로 구현 방식은 저자마다 다릅니다. 설치 및 문제 해결 방법은 [맞춤형 노드 설치 방법](/installation/install_custom_node)을 참조하세요. +- **다수의 다른 모델은 커뮤니티의 커스텀 노드를 통해 활성화됩니다.** 경로, 로더 노드, 그래프 레이아웃은 이 페이지의 일반적인 `ComfyUI/models/` 안내와 다를 수 있으므로 **각 프로젝트의 README나 문서를 반드시 따르세요**. ComfyUI는 매우 확장성이 뛰어나므로 구현 방식은 저자마다 다릅니다. 설치 및 문제 해결 방법은 [커스텀 노드 설치 방법](/installation/install_custom_node)을 참조하세요. ## ComfyUI에서 모델 사용하기 @@ -49,7 +49,7 @@ ComfyUI에서 **모델**이란 실제로 워크플로우를 실행하는 가중 - ComfyUI는 기본적으로 GGUF 형식 모델을 지원하지 않습니다. GGUF 모델을 사용하려면 [ComfyUI-GGUF](https://github.com/city96/ComfyUI-GGUF)와 같은 커뮤니티 맞춤형 노드를 설치해야 합니다. + ComfyUI는 기본적으로 GGUF 형식 모델을 지원하지 않습니다. GGUF 모델을 사용하려면 [ComfyUI-GGUF](https://github.com/city96/ComfyUI-GGUF)와 같은 커뮤니티 커스텀 노드를 설치해야 합니다. diff --git a/ko/development/core-concepts/workflow.mdx b/ko/development/core-concepts/workflow.mdx index 882f77e9f..1b9851cd2 100644 --- a/ko/development/core-concepts/workflow.mdx +++ b/ko/development/core-concepts/workflow.mdx @@ -19,7 +19,7 @@ ComfyUI 워크플로우는 이미지, 비디오, 오디오, AI 모델, AI 에이 ## 샘플 워크플로우 -시작하려면 내장된 [워크플로우 템플릿](/interface/features/template)을 사용하세요. 메뉴에서 `워크플로우` → `워크플로우 템플릿 둘러보기`를 통해 열 수 있습니다. 이 템플릿들은 ComfyUI 설치에 포함된 핵심 노드만 사용하며, 필요한 모델을 다운로드하도록 자동으로 안내해줍니다. 활발한 개발자 커뮤니티가 ComfyUI의 기능을 확장하기 위한 다양한 맞춤형 노드로 이루어진 풍부한 [생태계](https://registry.comfy.org)를 만들었습니다. +시작하려면 내장된 [워크플로우 템플릿](/interface/features/template)을 사용하세요. 메뉴에서 `워크플로우` → `워크플로우 템플릿 둘러보기`를 통해 열 수 있습니다. 이 템플릿들은 ComfyUI 설치에 포함된 핵심 노드만 사용하며, 필요한 모델을 다운로드하도록 자동으로 안내해줍니다. 활발한 개발자 커뮤니티가 ComfyUI의 기능을 확장하기 위한 다양한 커스텀 노드로 이루어진 풍부한 [생태계](https://registry.comfy.org)를 만들었습니다. ### 간단한 예시 ![간단한 워크플로우](/images/simple_workflow.jpg) diff --git a/ko/development/overview.mdx b/ko/development/overview.mdx index 20143804e..c35cf7f37 100644 --- a/ko/development/overview.mdx +++ b/ko/development/overview.mdx @@ -5,7 +5,7 @@ translationSourceHash: c329e073 translationFrom: development/overview.mdx --- -ComfyUI는 서버로 실행되고 API를 통해 접근 가능하며, 맞춤형 노드로 확장할 수 있고 명령줄에서 관리 가능한 모듈식 GenAI 추론 엔진입니다. 아래에서 원하는 방식을 선택하세요. +ComfyUI는 서버로 실행되고 API를 통해 접근 가능하며, 커스텀 노드로 확장할 수 있고 명령줄에서 관리 가능한 모듈식 GenAI 추론 엔진입니다. 아래에서 원하는 방식을 선택하세요. ## ComfyUI를 서버로 배포하기 @@ -39,7 +39,7 @@ ComfyUI는 서버로 실행되고 API를 통해 접근 가능하며, 맞춤형 ## Comfy CLI -명령줄에서 ComfyUI 설치, 맞춤형 노드 및 워크플로를 관리하세요. 간편하게 설치, 업데이트, 구성 및 자동화하세요. +명령줄에서 ComfyUI 설치, 커스텀 노드 및 워크플로를 관리하세요. 간편하게 설치, 업데이트, 구성 및 자동화하세요. 터미널에서 ComfyUI를 설치, 업데이트 및 관리하는 방법을 알아보세요. @@ -47,19 +47,19 @@ ComfyUI는 서버로 실행되고 API를 통해 접근 가능하며, 맞춤형 참고: [CLI 참조](/ko/comfy-cli/reference) · [문제 해결](/ko/comfy-cli/troubleshooting) -## 맞춤형 노드 개발하기 +## 커스텀 노드 개발하기 -맞춤형 노드를 통해 자신만의 Python 백엔드, JavaScript UI 위젯 및 통합 기능으로 ComfyUI를 확장할 수 있습니다. 이는 생태계에 기여할 수 있는 가장 강력한 방법 중 하나입니다. +커스텀 노드를 통해 자신만의 Python 백엔드, JavaScript UI 위젯 및 통합 기능으로 ComfyUI를 확장할 수 있습니다. 이는 생태계에 기여할 수 있는 가장 강력한 방법 중 하나입니다. - 맞춤형 노드가 처음이라면? 노드의 구조, 게시 방법 및 모범 사례를 알아보세요. + 커스텀 노드가 처음이라면? 노드의 구조, 게시 방법 및 모범 사례를 알아보세요.

주요 페이지: 워크스루 · v3 마이그레이션 가이드 - 맞춤형 노드의 서버 측을 구축하세요. 데이터 유형, 이미지 및 마스크 처리, 지연 평가, 텐서 등에 대해 다룹니다. + 커스텀 노드의 서버 측을 구축하세요. 데이터 유형, 이미지 및 마스크 처리, 지연 평가, 텐서 등에 대해 다룹니다.

주요 페이지: 데이터 유형 · 이미지 및 마스크 · 지연 평가 · 노드 확장 @@ -76,7 +76,7 @@ ComfyUI는 서버로 실행되고 API를 통해 접근 가능하며, 맞춤형 ## 레지스트리 -Comfy 레지스트리를 통해 맞춤형 노드를 게시하고 관리하세요. 레지스트리는 버전 관리, 보안 스캔 및 커뮤니티를 위한 검색 기능을 제공합니다. +Comfy 레지스트리를 통해 커스텀 노드를 게시하고 관리하세요. 레지스트리는 버전 관리, 보안 스캔 및 커뮤니티를 위한 검색 기능을 제공합니다. 게시자로 등록하고 첫 번째 노드를 게시하며, 기존 노드를 인수하고 자동 릴리스를 위한 CI/CD를 설정하세요. diff --git a/ko/get_started/cloud.mdx b/ko/get_started/cloud.mdx index fc66813ae..f69fb49de 100644 --- a/ko/get_started/cloud.mdx +++ b/ko/get_started/cloud.mdx @@ -19,7 +19,7 @@ ComfyUI Cloud는 로컬 버전과 동일한 기능을 갖춘 ComfyUI의 클라 - 설치가 필요 없습니다. 모든 모델과 맞춤형 노드가 사전 설치되어 바로 사용 가능합니다. + 설치가 필요 없습니다. 모든 모델과 커스텀 노드가 사전 설치되어 바로 사용 가능합니다. @@ -44,8 +44,8 @@ ComfyUI는 공식 클라우드 버전인 [Comfy Cloud](https://comfy.org/cloud) |----------|-------------|------------------------------| | **비용** | 월간 구독 | 무료 | | **GPU** | 강력한 Blackwell RTX 6000 Pro | 직접 GPU 준비 필요 | -| **기술 지식** | 기술 지식이 필요 없습니다. | 데스크톱 및 휴대용 버전은 쉽게 시작할 수 있지만, 맞춤형 노드 설치 및 로컬 설치 문제 해결이 필요합니다. | -| **맞춤형 노드** | 사전 설치된 맞춤형 노드를 사용하며 호환성 문제를 걱정할 필요가 없습니다. | 원하는 맞춤형 노드를 설치할 수 있지만 직접 관리해야 합니다. | +| **기술 지식** | 기술 지식이 필요 없습니다. | 데스크톱 및 휴대용 버전은 쉽게 시작할 수 있지만, 커스텀 노드 설치 및 로컬 설치 문제 해결이 필요합니다. | +| **커스텀 노드** | 사전 설치된 커스텀 노드를 사용하며 호환성 문제를 걱정할 필요가 없습니다. | 원하는 커스텀 노드를 설치할 수 있지만 직접 관리해야 합니다. | | **모델** | 사전 설치된 모델을 사용합니다. Civitai에서 LoRA 모델을 가져올 수 있습니다. Hugging Face에서 모델을 가져올 예정입니다(곧 출시). | 원하는 모델을 사용할 수 있지만 먼저 다운로드해야 합니다. | | **주목할 만한 차이점** | 팀 구성이 용이함 | 오프라인에서도 작동하며 무한히 커스터마이징 가능 | | **시작하기** | [ComfyUI Cloud 실행하기](https://comfy.org/cloud) | [로컬 ComfyUI 설치하기](/installation/system_requirements) | diff --git a/ko/index.mdx b/ko/index.mdx index fc9aa1842..f2ba9336a 100644 --- a/ko/index.mdx +++ b/ko/index.mdx @@ -131,11 +131,11 @@ translationFrom: index.mdx ComfyUI 개발에 기여하기 - 맞춤형 노드 만들고 배포하기 + 커스텀 노드 만들고 배포하기 -맞춤형 노드를 설치하기 전에 주의 깊게 검토하는 것이 중요합니다. ComfyUI는 오픈소스 프로젝트이므로 악성 플러그인이 맞춤형 노드를 악용할 가능성이 있습니다: -1. 신뢰할 수 있는 저자와 커뮤니티에서 일반적으로 사용되는 맞춤형 노드만 설치하세요. +커스텀 노드를 설치하기 전에 주의 깊게 검토하는 것이 중요합니다. ComfyUI는 오픈소스 프로젝트이므로 악성 플러그인이 커스텀 노드를 악용할 가능성이 있습니다: +1. 신뢰할 수 있는 저자와 커뮤니티에서 일반적으로 사용되는 커스텀 노드만 설치하세요. 2. 플러그인의 기능을 이해한 후 설치하고, 알 수 없는 출처는 피하여 시스템 보안을 유지하세요. 3. 낯선 또는 의심스러운 플러그인은 설치하지 마세요—검증되지 않은 플러그인은 시스템 침해로 이어질 수 있는 보안 위험을 초래할 수 있습니다. -모든 맞춤형 노드 설치에는 다음 두 단계를 완료해야 합니다: +모든 커스텀 노드 설치에는 다음 두 단계를 완료해야 합니다: 1. 노드 코드를 `ComfyUI/custom_nodes` 디렉터리에 복제하기 2. 필요한 파이썬 종속성을 설치하기 @@ -31,7 +31,7 @@ translationFrom: installation/install_custom_node.mdx | **Git 복제** | 레지스트리에 등록되지 않은 노드도 설치 가능 | 1. Git 지식 필요
2. 수동 종속성 관리
3. 설치 위험 | | **레포지토리 ZIP 다운로드** | 1. Git 필요 없음
2. 수동 제어 | 1. 수동 종속성 관리
2. 버전 관리 없음
3. 설치 위험 | -팁: 맞춤형 노드를 설치하기 전에 플러그인의 README 파일을 확인하여 설치 방법, 사용법, 특정 모델이나 종속성 버전 요구사항, 일반적인 문제 해결 방법 등을 숙지하세요. +팁: 커스텀 노드를 설치하기 전에 플러그인의 README 파일을 확인하여 설치 방법, 사용법, 특정 모델이나 종속성 버전 요구사항, 일반적인 문제 해결 방법 등을 숙지하세요. ## 방법 1: ComfyUI 매니저(권장) @@ -39,14 +39,14 @@ translationFrom: installation/install_custom_node.mdx 이 방법을 사용하려면 환경에 ComfyUI 매니저가 있어야 합니다. 없거나 비활성화된 경우 [ComfyUI 매니저 개요](/manager/overview)와 [설치 가이드](/manager/install)를 참고하세요. -ComfyUI 매니저는 맞춤형 노드를 관리하는 두 가지 UI 버전을 제공합니다. 인터페이스에 맞는 가이드를 선택하세요: +ComfyUI 매니저는 커스텀 노드를 관리하는 두 가지 UI 버전을 제공합니다. 인터페이스에 맞는 가이드를 선택하세요: 데스크탑 사용자를 위해 기본적으로 활성화된 새 노드 관리 인터페이스입니다. - 맞춤형 노드 설치를 위한 클래식 매니저 인터페이스입니다. + 커스텀 노드 설치를 위한 클래식 매니저 인터페이스입니다. @@ -117,11 +117,11 @@ Git나 매니저를 사용할 수 없는 사용자에게 적합합니다 -## 맞춤형 노드 리소스 +## 커스텀 노드 리소스 -ComfyUI에서는 기본 노드 확장 기능 외에도 맞춤형 노드는 다음과 같은 추가 리소스를 포함할 수 있습니다: -- [노드 문서](/custom-nodes/help_page): 모든 맞춤형 노드와 기본 노드를 지원합니다. 노드 문서를 보고 노드의 목적과 사용법을 이해하며, 작성자에게 PR을 통해 문서를 기여할 수 있습니다. -- [맞춤형 노드 워크플로우 템플릿](/custom-nodes/workflow_templates): 노드 작성자가 제공하는 예시 워크플로우 템플릿으로, ComfyUI 템플릿에서 탐색하고 불러올 수 있습니다. +ComfyUI에서는 기본 노드 확장 기능 외에도 커스텀 노드는 다음과 같은 추가 리소스를 포함할 수 있습니다: +- [노드 문서](/custom-nodes/help_page): 모든 커스텀 노드와 기본 노드를 지원합니다. 노드 문서를 보고 노드의 목적과 사용법을 이해하며, 작성자에게 PR을 통해 문서를 기여할 수 있습니다. +- [커스텀 노드 워크플로우 템플릿](/custom-nodes/workflow_templates): 노드 작성자가 제공하는 예시 워크플로우 템플릿으로, ComfyUI 템플릿에서 탐색하고 불러올 수 있습니다. - [다국어 지원](/custom-nodes/i18n) -맞춤형 노드 개발자라면 이러한 리소스를 추가해 사용자 친화성을 높일 수 있습니다. \ No newline at end of file +커스텀 노드 개발자라면 이러한 리소스를 추가해 사용자 친화성을 높일 수 있습니다. \ No newline at end of file diff --git a/ko/installation/update_comfyui.mdx b/ko/installation/update_comfyui.mdx index 92e35875b..56c90f165 100644 --- a/ko/installation/update_comfyui.mdx +++ b/ko/installation/update_comfyui.mdx @@ -42,7 +42,7 @@ ComfyUI_windows_portable **위험:** - 기존 설정과의 의존성 충돌을 일으킬 수 있음 -- 특정 패키지 버전에 의존하는 맞춤형 노드를 깨뜨릴 수 있음 +- 특정 패키지 버전에 의존하는 커스텀 노드를 깨뜨릴 수 있음 - 수동으로 구성한 패키지를 덮어쓸 수 있음 **⚠️ 이 스크립트는 다음 경우에만 사용하세요:** @@ -53,7 +53,7 @@ ComfyUI_windows_portable **이 스크립트를 실행하기 전에:** 1. ComfyUI 전체 설치본 백업하기 2. 설치한 맞춤형 패키지 버전 기록하기 -3. 필요하다면 맞춤형 노드를 다시 설치할 준비 갖추기 +3. 필요하다면 커스텀 노드를 다시 설치할 준비 갖추기 @@ -293,7 +293,7 @@ comfy-aimdo # ComfyUI 핵심 유틸리티 ### 업데이트 후 오류가 발생하면 어떻게 해야 하나요? 1. **의존성 확인**: `pip install -r requirements.txt`를 실행해 모든 의존성이 업데이트되었는지 확인하세요 -2. **맞춤형 노드 확인**: 일부 맞춤형 노드가 새 버전과 호환되지 않을 수 있습니다 +2. **커스텀 노드 확인**: 일부 커스텀 노드가 새 버전과 호환되지 않을 수 있습니다 3. **버전 롤백**: 문제가 심각하다면 이전 안정 버전으로 롤백할 수 있습니다 문제가 발생하면 당사의 문제 해결 페이지를 참고해 해결하세요. diff --git a/ko/interface/features/template.mdx b/ko/interface/features/template.mdx index d33465d9c..c49a0f3e6 100644 --- a/ko/interface/features/template.mdx +++ b/ko/interface/features/template.mdx @@ -1,18 +1,18 @@ --- title: "템플릿 - ComfyUI 기본 제공 워크플로우 템플릿" -description: "템플릿은 ComfyUI에서 기본적으로 지원하는 모델 워크플로우와 맞춤형 노드의 예시 워크플로우를 제공합니다. 현재 지원되는 모델의 워크플로우를 여기서 찾아 사용할 수 있습니다." +description: "템플릿은 ComfyUI에서 기본적으로 지원하는 모델 워크플로우와 커스텀 노드의 예시 워크플로우를 제공합니다. 현재 지원되는 모델의 워크플로우를 여기서 찾아 사용할 수 있습니다." sidebarTitle: "워크플로우 템플릿" icon: "clone" translationSourceHash: 1fa0af3f translationFrom: interface/features/template.mdx --- -워크플로우 템플릿은 ComfyUI에서 기본적으로 지원하는 모델 워크플로우와 맞춤형 노드의 일부 예시 워크플로우를 위한 브라우저입니다. +워크플로우 템플릿은 ComfyUI에서 기본적으로 지원하는 모델 워크플로우와 커스텀 노드의 일부 예시 워크플로우를 위한 브라우저입니다. ComfyUI의 워크플로우 템플릿에서는 다음을 찾을 수 있습니다: - 기본적으로 지원되는 모델 워크플로우 -- 맞춤형 노드의 예시 워크플로우 +- 커스텀 노드의 예시 워크플로우 ![템플릿](/images/interface/features/template/template_library.png) @@ -135,12 +135,12 @@ comfyui-embedded-docs==0.2.4 2. 템플릿은 기존 템플릿과 중복되지 않고 지원되는 모델 기능을 타겟으로 해야 합니다. 3. 리포지토리에 이슈를 열어 질문을 남길 수 있습니다. -## 맞춤형 노드 템플릿 +## 커스텀 노드 템플릿 -맞춤형 노드 작성자가 템플릿과 예시 워크플로우를 제공한다면, 템플릿 브라우저에서도 이를 찾을 수 있습니다. 일반적으로 노드 이름을 따온 카테고리를 찾아 모든 템플릿을 찾을 수 있습니다. +커스텀 노드 작성자가 템플릿과 예시 워크플로우를 제공한다면, 템플릿 브라우저에서도 이를 찾을 수 있습니다. 일반적으로 노드 이름을 따온 카테고리를 찾아 모든 템플릿을 찾을 수 있습니다. -맞춤형 노드 작성자라면, 현재 `templates` 폴더 아래 한 단계의 디렉터리만 지원되고(중첩된 하위 디렉터리는 지원되지 않음), JSON 형식의 템플릿만 지원된다는 점을 유의하세요. +커스텀 노드 작성자라면, 현재 `templates` 폴더 아래 한 단계의 디렉터리만 지원되고(중첩된 하위 디렉터리는 지원되지 않음), JSON 형식의 템플릿만 지원된다는 점을 유의하세요. -## 맞춤형 노드용 템플릿을 추가하려면? +## 커스텀 노드용 템플릿을 추가하려면? -[맞춤형 노드 템플릿](/custom-nodes/workflow_templates)을 참고해 맞춤형 노드용 워크플로우 템플릿을 추가하는 방법을 알아보세요. \ No newline at end of file +[커스텀 노드 템플릿](/custom-nodes/workflow_templates)을 참고해 커스텀 노드용 워크플로우 템플릿을 추가하는 방법을 알아보세요. \ No newline at end of file diff --git a/ko/interface/nodes-2.mdx b/ko/interface/nodes-2.mdx index 8ca839f3e..14db31acd 100644 --- a/ko/interface/nodes-2.mdx +++ b/ko/interface/nodes-2.mdx @@ -26,7 +26,7 @@ translationFrom: interface/nodes-2.mdx | 분야 | 상태 | |------|--------| | **성능** | 여전히 캔버스 수준의 성능을 목표로 최적화 중입니다. 특정 시나리오에서는 다르게 동작할 수 있습니다. | -| **호환성** | 일부 맞춤형 노드는 완벽한 지원을 위해 업데이트가 필요할 수 있습니다. | +| **호환성** | 일부 커스텀 노드는 완벽한 지원을 위해 업데이트가 필요할 수 있습니다. | | **특수 사례** | 극단적인 확대/축소 수준이나 매우 큰 워크플로우 내에서는 약간의 시각적 문제가 나타날 수 있습니다. | 우리는 피드백을 수집해 개선 우선순위를 정하고 있습니다. LiteGraph.js 렌더링 시스템은 계속 사용 가능하며, 언제든지 두 시스템 간에 전환할 수 있습니다. @@ -43,7 +43,7 @@ translationFrom: interface/nodes-2.mdx 일상적인 워크플로우에서 노드 2.0을 사용해 보고 우리에게 피드백을 공유해 주세요: - **기본 상호작용** - 드래그, 크기 조정, 선택 -- **일상적인 워크플로우** - 실행, 파라미터, 맞춤형 노드 +- **일상적인 워크플로우** - 실행, 파라미터, 커스텀 노드 - **성능** - 특히 복잡한 워크플로우에서 확인해 주세요. ## 피드백 제공 방법 diff --git a/ko/interface/overview.mdx b/ko/interface/overview.mdx index f18e706f8..ca8b0d689 100644 --- a/ko/interface/overview.mdx +++ b/ko/interface/overview.mdx @@ -60,7 +60,7 @@ translationFrom: interface/overview.mdx 현재 ComfyUI에서는 다음 기능을 가진 네 개의 사이드바 패널을 제공합니다: 1. 작업 흐름 역사 대기열 (Queue): ComfyUI가 미디어 콘텐츠 생성을 수행하는 모든 대기열 정보 -2. 노드 라이브러리: ComfyUI의 모든 노드, `Comfy Core` 및 설치된 맞춤형 노드를 여기서 찾을 수 있습니다 +2. 노드 라이브러리: ComfyUI의 모든 노드, `Comfy Core` 및 설치된 커스텀 노드를 여기서 찾을 수 있습니다 3. 모델 라이브러리: 로컬 `ComfyUI/models` 디렉토리의 모델을 여기서 찾을 수 있습니다 4. 로컬 사용자 작업 흐름 (Workflows): 로컬에 저장된 사용자 작업 흐름을 여기서 찾을 수 있습니다 diff --git a/ko/interface/settings/about.mdx b/ko/interface/settings/about.mdx index e7adce0be..586569049 100644 --- a/ko/interface/settings/about.mdx +++ b/ko/interface/settings/about.mdx @@ -29,9 +29,9 @@ About 페이지에는 다음과 같은 핵심 버전 정보가 표시됩니다: 또 다른 흔한 문제는 업데이트 과정에서 서로 다른 종속성 패키지가 실패하거나 롤백될 수 있다는 점입니다. -### 맞춤형 노드 배지 +### 커스텀 노드 배지 -맞춤형 노드가 설치된 경우, About 페이지는 맞춤형 노드가 제공하는 추가 배지 정보도 표시합니다. 이 배지는 각 맞춤형 노드가 `aboutPageBadges` 속성을 통해 등록한 것입니다. +커스텀 노드가 설치된 경우, About 페이지는 커스텀 노드가 제공하는 추가 배지 정보도 표시합니다. 이 배지는 각 커스텀 노드가 `aboutPageBadges` 속성을 통해 등록한 것입니다. ### 시스템 정보 diff --git a/ko/interface/settings/server-config.mdx b/ko/interface/settings/server-config.mdx index bdbdaafb5..7cccb357c 100644 --- a/ko/interface/settings/server-config.mdx +++ b/ko/interface/settings/server-config.mdx @@ -228,7 +228,7 @@ import SettingsMenuContext from "/snippets/interface/settings-menu-context.mdx" ### 프롬프트 메타데이터를 파일에 저장하지 않음 **기능**: 생성된 이미지에 워크플로우 정보를 저장하지 않으며, 파일 크기를 줄이지만 해당 워크플로우 정보가 손실되어 워크플로우 출력 파일을 사용해 해당 생성 결과를 재현할 수 없게 됩니다. -### 모든 맞춤형 노드 로드 비활성화 +### 모든 커스텀 노드 로드 비활성화 **기능**: 모든 서드파티 확장 노드를 로드하지 않으며, 주로 문제를 진단해 서드파티 확장 노드가 원인인지 확인할 때 사용됩니다. ### 로깅 세부정보 수준 diff --git a/ko/manager/configuration.mdx b/ko/manager/configuration.mdx index e3a9dfdbb..34736d16e 100644 --- a/ko/manager/configuration.mdx +++ b/ko/manager/configuration.mdx @@ -72,8 +72,8 @@ network_mode = | 위험 레벨 | 기능 | |------------|----------| -| **고위험** | git url을 통한 설치, pip install, 기본 채널에 없는 맞춤형 노드 설치, 맞춤형 노드 수정 | -| **중위험** | 제거/업데이트, 기본 채널 내 맞춤형 노드 설치, 스냅샷 복원/제거, 재시작 | +| **고위험** | git url을 통한 설치, pip install, 기본 채널에 없는 커스텀 노드 설치, 커스텀 노드 수정 | +| **중위험** | 제거/업데이트, 기본 채널 내 커스텀 노드 설치, 스냅샷 복원/제거, 재시작 | | **저위험** | ComfyUI 업데이트 | ## 환경 변수 @@ -116,7 +116,7 @@ downgrade_blacklist = diffusers, kornia ### pip 설치 자동 복구 -`pip_auto_fix.list`에 pip spec 요구사항을 나열하세요 (`requirements.txt`와 유사). ComfyUI를 시작하거나 맞춤형 노드 설치 중 버전이 불일치할 경우 자동으로 지정된 버전을 복구합니다. `--index-url`를 사용할 수 있습니다. +`pip_auto_fix.list`에 pip spec 요구사항을 나열하세요 (`requirements.txt`와 유사). ComfyUI를 시작하거나 커스텀 노드 설치 중 버전이 불일치할 경우 자동으로 지정된 버전을 복구합니다. `--index-url`를 사용할 수 있습니다. ### aria2를 다운로더로 사용하기 @@ -126,12 +126,12 @@ downgrade_blacklist = diffusers, kornia 다음 설정은 `is_default`로 표시된 섹션에 따라 적용됩니다: -- `custom_nodes`: 맞춤형 노드 설치 경로 +- `custom_nodes`: 커스텀 노드 설치 경로 - `download_model_base`: 모델 다운로드 경로 ## CLI 도구 -ComfyUI-Manager는 ComfyUI를 실행하지 않고도 Manager 기능을 사용할 수 있는 명령줄 도구인 `cm-cli`를 제공합니다. 이는 맞춤형 노드 설치를 자동화하고 헤드리스 환경에서 설치를 관리하는 데 유용합니다. +ComfyUI-Manager는 ComfyUI를 실행하지 않고도 Manager 기능을 사용할 수 있는 명령줄 도구인 `cm-cli`를 제공합니다. 이는 커스텀 노드 설치를 자동화하고 헤드리스 환경에서 설치를 관리하는 데 유용합니다. 자세한 cm-cli 문서는 [공식 cm-cli 가이드](https://github.com/Comfy-Org/ComfyUI-Manager/blob/main/docs/en/cm-cli.md)를 참조하세요. diff --git a/ko/manager/legacy-ui.mdx b/ko/manager/legacy-ui.mdx index af93ef5be..e94e89195 100644 --- a/ko/manager/legacy-ui.mdx +++ b/ko/manager/legacy-ui.mdx @@ -1,13 +1,13 @@ --- -title: ComfyUI-Manager를 사용한 맞춤형 노드 관리(레거시 UI) +title: ComfyUI-Manager를 사용한 커스텀 노드 관리(레거시 UI) sidebarTitle: 레거시 UI -description: "레거시 인터페이스를 사용해 ComfyUI-Manager로 맞춤형 노드를 설치, 업데이트 및 관리하세요" +description: "레거시 인터페이스를 사용해 ComfyUI-Manager로 커스텀 노드를 설치, 업데이트 및 관리하세요" translationSourceHash: 858ef93e translationFrom: manager/legacy-ui.mdx --- -## ComfyUI 맞춤형 노드 관리 -매니저를 통해 맞춤형 노드를 설치하는 방법을 알아보세요 +## ComfyUI 커스텀 노드 관리 +매니저를 통해 커스텀 노드를 설치하는 방법을 알아보세요 ### 노드 설치하기 @@ -48,22 +48,22 @@ translationFrom: manager/legacy-ui.mdx 워크플로드를 로드할 때 누락된 노드는 흔히 발생하는 상황입니다. 일반적으로 두 가지 유형의 누락된 노드가 있습니다: 1. 핵심 노드 누락: ComfyUI 버전이 최신 버전이 아닙니다. [ComfyUI 업데이트](/installation/update_comfyui)를 참고해 ComfyUI를 업데이트하세요 -2. 맞춤형 노드 누락: 서드파티 맞춤형 노드가 누락된 경우, 이 가이드를 참고해 설치하세요 +2. 커스텀 노드 누락: 서드파티 커스텀 노드가 누락된 경우, 이 가이드를 참고해 설치하세요 -ComfyUI-Manager가 설치된 후 워크플로드를 가져올 때 누락된 맞춤형 노드가 있으면, 누락된 노드 정보가 알림으로 표시됩니다. +ComfyUI-Manager가 설치된 후 워크플로드를 가져올 때 누락된 커스텀 노드가 있으면, 누락된 노드 정보가 알림으로 표시됩니다. ![누락된 노드 알림](/images/manager/manger_missing_nodes-1.jpg) 1. **매니저 열기**를 클릭해 해당 옵션을 활성화하세요 ![누락된 노드 알림](/images/manager/manger_missing_nodes-2.jpg) -2. 매니저 메뉴에서 **누락된 맞춤형 노드 설치**를 클릭해 누락된 노드 목록 화면으로 이동하세요 +2. 매니저 메뉴에서 **누락된 커스텀 노드 설치**를 클릭해 누락된 노드 목록 화면으로 이동하세요 ![누락된 노드 알림](/images/manager/manger_missing_nodes-3.jpg) 3. 노드 목록에서 해당 노드를 확인하고 설치하세요 만약 누락된 노드 목록에서 해당 노드를 찾을 수 없다면, 일반적으로 다음과 같은 몇 가지 상황이 있을 수 있습니다: -1. 해당 노드의 작성자가 맞춤형 노드를 [레지스트리](/registry/overview)에 제출하고 등록하지 않았습니다. +1. 해당 노드의 작성자가 커스텀 노드를 [레지스트리](/registry/overview)에 제출하고 등록하지 않았습니다. 2. 해당 노드가 오픈소스가 아니며, 특정 작가나 제한된 플랫폼에서 제공하는 제한적 노드일 수 있습니다. 3. 원작자가 버전을 변경하고 해당 노드를 삭제했습니다. @@ -84,11 +84,11 @@ ComfyUI-Manager가 설치된 후 워크플로드를 가져올 때 누락된 맞 플러그인을 설치하는 다른 방법은 아래 기사를 참고하세요 - 수동으로 맞춤형 노드를 설치하는 방법을 알아보세요 + 수동으로 커스텀 노드를 설치하는 방법을 알아보세요 ## 스냅샷 관리자 @@ -102,5 +102,5 @@ ComfyUI-Manager가 설치된 후 워크플로드를 가져올 때 누락된 맞 복원하려면: 스냅샷 관리자를 열고 스냅샷을 선택한 후 **복원**을 누르세요. -복원은 다음 ComfyUI 시작 시 적용됩니다. Git으로 관리되지 않는 맞춤형 노드의 경우 스냅샷 지원이 완벽하지 않을 수 있습니다. +복원은 다음 ComfyUI 시작 시 적용됩니다. Git으로 관리되지 않는 커스텀 노드의 경우 스냅샷 지원이 완벽하지 않을 수 있습니다. \ No newline at end of file diff --git a/ko/manager/overview.mdx b/ko/manager/overview.mdx index 968b42b51..993b58f17 100644 --- a/ko/manager/overview.mdx +++ b/ko/manager/overview.mdx @@ -1,18 +1,18 @@ --- title: 개요 sidebarTitle: 개요 -description: "ComfyUI에서 맞춤형 노드, 모델 등을 관리하는 확장 프로그램" +description: "ComfyUI에서 커스텀 노드, 모델 등을 관리하는 확장 프로그램" translationSourceHash: d9b5c989 translationFrom: manager/overview.mdx --- -**ComfyUI-Manager**는 [ComfyUI](https://github.com/Comfy-Org/ComfyUI)의 사용성을 향상시키기 위해 설계된 확장 프로그램입니다. 이 확장 프로그램은 ComfyUI의 다양한 맞춤형 노드를 **설치, 제거, 비활성화 및 활성화**할 수 있는 관리 기능을 제공합니다. 또한 이 확장 프로그램은 허브 기능과 편의 기능을 통해 ComfyUI 내의 광범위한 정보에 쉽게 접근할 수 있도록 합니다. +**ComfyUI-Manager**는 [ComfyUI](https://github.com/Comfy-Org/ComfyUI)의 사용성을 향상시키기 위해 설계된 확장 프로그램입니다. 이 확장 프로그램은 ComfyUI의 다양한 커스텀 노드를 **설치, 제거, 비활성화 및 활성화**할 수 있는 관리 기능을 제공합니다. 또한 이 확장 프로그램은 허브 기능과 편의 기능을 통해 ComfyUI 내의 광범위한 정보에 쉽게 접근할 수 있도록 합니다. ![ComfyUI-Manager 대화창](/images/manager/new_comfyui_manager.png) ## 주요 기능 -- **맞춤형 노드 관리**: 맞춤형 노드 설치, 업데이트, 제거 및 비활성화 +- **커스텀 노드 관리**: 커스텀 노드 설치, 업데이트, 제거 및 비활성화 - **모델 관리**: 다양한 출처에서 모델을 다운로드하고 관리 - **스냅샷 관리**: 설치 상태 저장 및 복원 - **누락 노드 탐지**: 워크플로우에서 누락된 노드를 자동으로 탐지하고 설치 @@ -24,10 +24,10 @@ translationFrom: manager/overview.mdx 설정에 맞춰 ComfyUI-Manager를 설치하세요 - 새로운 UI를 통해 맞춤형 노드와 모델을 관리하세요 + 새로운 UI를 통해 커스텀 노드와 모델을 관리하세요 - 레거시 UI를 통해 맞춤형 노드와 모델을 관리하세요 + 레거시 UI를 통해 커스텀 노드와 모델을 관리하세요 설정 및 옵션을 구성하세요 diff --git a/ko/manager/pack-management.mdx b/ko/manager/pack-management.mdx index bb877e55e..dd5bd908a 100644 --- a/ko/manager/pack-management.mdx +++ b/ko/manager/pack-management.mdx @@ -1,7 +1,7 @@ --- -title: 맞춤형 노드(새로운 UI) +title: 커스텀 노드(새로운 UI) sidebarTitle: 새로운 UI -description: "ComfyUI-Manager를 사용하여 새로운 인터페이스를 통해 맞춤형 노드를 설치, 업데이트 및 관리하세요" +description: "ComfyUI-Manager를 사용하여 새로운 인터페이스를 통해 커스텀 노드를 설치, 업데이트 및 관리하세요" translationSourceHash: f175b3d9 translationFrom: manager/pack-management.mdx --- @@ -20,13 +20,13 @@ translationFrom: manager/pack-management.mdx ## 노드 관리 -새로운 ComfyUI Manager를 사용해 맞춤형 노드를 관리하는 방법을 알아보세요 +새로운 ComfyUI Manager를 사용해 커스텀 노드를 관리하는 방법을 알아보세요 ### 노드 검색 ![필터](/images/manager/new_ui_filter.jpg) Manager는 노드 팩과 개별 노드를 각각 별도로 검색할 수 있도록 지원합니다. 위와 같이 필터를 토글하여 검색 유형을 전환할 수 있습니다. -- 노드 팩: 완전한 맞춤형 노드 팩 +- 노드 팩: 완전한 커스텀 노드 팩 - 개별 노드: 노드 팩 내 개별 노드 검색 ### 노드 설치 @@ -63,4 +63,4 @@ ComfyUI Manager가 올바르게 설치된 경우, 누락된 노드가 포함된 새로운 Manager는 오직 [레지스트리](/registry/overview)에서 노드를 설치하는 것을 지원합니다. 만약 귀하의 노드가 레지스트리에 등록되지 않았다면 먼저 Manager에 등록해 주세요. 2. git을 통해 설치하는 옵션이 보이지 않는 이유는 무엇인가요? -ComfyUI 사용자 시스템의 보안과 안정성을 위해 새로운 UI에서는 git을 통한 노드 설치를 지원하지 않습니다. 자세한 내용은 [맞춤형 노드 수동 설치](/installation/install_custom_node)를 참고해 주세요. \ No newline at end of file +ComfyUI 사용자 시스템의 보안과 안정성을 위해 새로운 UI에서는 git을 통한 노드 설치를 지원하지 않습니다. 자세한 내용은 [커스텀 노드 수동 설치](/installation/install_custom_node)를 참고해 주세요. \ No newline at end of file diff --git a/ko/registry/api-reference/overview.mdx b/ko/registry/api-reference/overview.mdx index 1b9763730..2aba5baea 100644 --- a/ko/registry/api-reference/overview.mdx +++ b/ko/registry/api-reference/overview.mdx @@ -6,7 +6,7 @@ translationFrom: registry/api-reference/overview.mdx ## 개요 -맞춤형 노드 레지스트리는 다음과 같은 구조를 따릅니다. +커스텀 노드 레지스트리는 다음과 같은 구조를 따릅니다. ```mermaid erDiagram diff --git a/ko/registry/cicd.mdx b/ko/registry/cicd.mdx index 19c75b7e8..dec28b59c 100644 --- a/ko/registry/cicd.mdx +++ b/ko/registry/cicd.mdx @@ -1,19 +1,19 @@ --- -title: "맞춤형 노드 CI/CD" +title: "커스텀 노드 CI/CD" translationSourceHash: 5ae8338a translationFrom: registry/cicd.mdx --- ## 소개 -맞춤형 노드를 변경할 때 Comfy나 다른 맞춤형 노드에서 문제가 발생하는 경우가 드물지 않습니다. 모든 운영체제와 다양한 PyTorch 구성에서 테스트를 수행하는 것은 종종 현실적이지 않습니다. +커스텀 노드를 변경할 때 Comfy나 다른 커스텀 노드에서 문제가 발생하는 경우가 드물지 않습니다. 모든 운영체제와 다양한 PyTorch 구성에서 테스트를 수행하는 것은 종종 현실적이지 않습니다. ### GitHub Actions를 사용한 Comfy 워크플로우 실행 -[Comfy-Action](https://github.com/Comfy-Org/comfy-action)을 사용하면 GitHub Actions에서 Comfy workflow.json 파일을 실행할 수 있습니다. 모델 다운로드, 맞춤형 노드 지원 및 Linux/Mac/Windows에서 실행됩니다. +[Comfy-Action](https://github.com/Comfy-Org/comfy-action)을 사용하면 GitHub Actions에서 Comfy workflow.json 파일을 실행할 수 있습니다. 모델 다운로드, 커스텀 노드 지원 및 Linux/Mac/Windows에서 실행됩니다. ### 결과 -출력 파일은 [CI/CD 대시보드](https://ci.comfy.org/)에 업로드되며, 새로운 변경사항을 커밋하거나 맞춤형 노드의 새 버전을 출시하기 전 마지막 단계에서 확인할 수 있습니다. +출력 파일은 [CI/CD 대시보드](https://ci.comfy.org/)에 업로드되며, 새로운 변경사항을 커밋하거나 커스텀 노드의 새 버전을 출시하기 전 마지막 단계에서 확인할 수 있습니다. ![ComfyCI](/images/comfyci.png) \ No newline at end of file diff --git a/ko/registry/claim-my-node.mdx b/ko/registry/claim-my-node.mdx index 13b2fc9c4..17d865c9a 100644 --- a/ko/registry/claim-my-node.mdx +++ b/ko/registry/claim-my-node.mdx @@ -6,11 +6,11 @@ translationFrom: registry/claim-my-node.mdx ## 개요 -**내 노드 신청하기** 기능을 통해 개발자는 ComfyUI 레지스트리의 맞춤형 노드에 대한 소유권을 주장할 수 있습니다. 이 시스템은 정당한 저자만이 자신이 게시한 노드를 관리하고 업데이트할 수 있도록 보장하며, 커뮤니티 내에서 보안과 책임성을 제공합니다. +**내 노드 신청하기** 기능을 통해 개발자는 ComfyUI 레지스트리의 커스텀 노드에 대한 소유권을 주장할 수 있습니다. 이 시스템은 정당한 저자만이 자신이 게시한 노드를 관리하고 업데이트할 수 있도록 보장하며, 커뮤니티 내에서 보안과 책임성을 제공합니다. ## 미신청 노드란? -ComfyUI 매니저에서 새로운 표준을 갖춘 Comfy 레지스트리로 이전하면서, 이전 ComfyUI 매니저 레거시 시스템에 등록되었던 많은 맞춤형 노드가 이제 레지스트리에서 '미신청' 상태로 나타납니다. 이러한 노드는 다음과 같은 특징을 가집니다: +ComfyUI 매니저에서 새로운 표준을 갖춘 Comfy 레지스트리로 이전하면서, 이전 ComfyUI 매니저 레거시 시스템에 등록되었던 많은 커스텀 노드가 이제 레지스트리에서 '미신청' 상태로 나타납니다. 이러한 노드는 다음과 같은 특징을 가집니다: - 원래 ComfyUI 매니저 레거시 시스템에 게시되었던 것들 - 최신 표준을 충족하도록 Comfy 레지스트리로 이전된 것들 diff --git a/ko/registry/migration.mdx b/ko/registry/migration.mdx index 9b9e865fa..fa34011de 100644 --- a/ko/registry/migration.mdx +++ b/ko/registry/migration.mdx @@ -6,6 +6,6 @@ translationFrom: registry/migration.mdx ## 소개 -ComfyUI의 역사 대부분 동안, 맞춤형 노드는 git를 사용해 설치해 왔습니다. 이 방법은 시작하기에 훌륭했지만 몇 가지 단점이 있었습니다. 이러한 단점들은 [개요](/registry/overview) 페이지에서 다루었습니다. 이 페이지에서는 git 설치 방식에서 레지스트리로 마이그레이션하는 방법을 다룰 것입니다. +ComfyUI의 역사 대부분 동안, 커스텀 노드는 git를 사용해 설치해 왔습니다. 이 방법은 시작하기에 훌륭했지만 몇 가지 단점이 있었습니다. 이러한 단점들은 [개요](/registry/overview) 페이지에서 다루었습니다. 이 페이지에서는 git 설치 방식에서 레지스트리로 마이그레이션하는 방법을 다룰 것입니다. ## 새로운 노드 시스템으로의 마이그레이션 \ No newline at end of file diff --git a/ko/registry/overview.mdx b/ko/registry/overview.mdx index 561d04adb..be22faaf9 100644 --- a/ko/registry/overview.mdx +++ b/ko/registry/overview.mdx @@ -6,13 +6,13 @@ translationFrom: registry/overview.mdx ## 소개 -레지스트리는 [ComfyUI-Manager](https://github.com/Comfy-Org/ComfyUI-Manager)를 구동하는 맞춤형 노드의 공개 컬렉션입니다. 개발자는 자신만의 맞춤형 노드를 게시하고, 버전 관리를 하며, 오래된 버전을 폐기하고, 관련 지표를 추적할 수 있습니다. ComfyUI 사용자는 ComfyUI-Manager를 통해 레지스트리에서 맞춤형 노드를 탐색하고 설치하며 평가할 수 있습니다. +레지스트리는 [ComfyUI-Manager](https://github.com/Comfy-Org/ComfyUI-Manager)를 구동하는 커스텀 노드의 공개 컬렉션입니다. 개발자는 자신만의 커스텀 노드를 게시하고, 버전 관리를 하며, 오래된 버전을 폐기하고, 관련 지표를 추적할 수 있습니다. ComfyUI 사용자는 ComfyUI-Manager를 통해 레지스트리에서 커스텀 노드를 탐색하고 설치하며 평가할 수 있습니다. ## 왜 레지스트리를 사용해야 할까요? -Comfy 레지스트리는 맞춤형 노드 개발을 표준화함으로써 커뮤니티를 돕습니다: +Comfy 레지스트리는 커스텀 노드 개발을 표준화함으로써 커뮤니티를 돕습니다: -  **노드 버전 관리:** 개발자들은 종종 맞춤형 노드의 새로운 버전을 출시하며, 이는 해당 노드에 의존하는 워크플로우를 깨뜨릴 수 있습니다. 레지스트리 노드는 [세미틱 버전 관리](https://semver.org/)를 사용하므로, 사용자는 자신의 행동이 워크플로우에 어떤 영향을 미칠지 미리 알고 안전하게 업그레이드하거나, 오래된 버전을 폐기하거나, 고정할 수 있습니다. 워크플로우 JSON에는 사용된 노드의 버전이 저장되므로 언제나 안정적으로 워크플로우를 재현할 수 있습니다. +  **노드 버전 관리:** 개발자들은 종종 커스텀 노드의 새로운 버전을 출시하며, 이는 해당 노드에 의존하는 워크플로우를 깨뜨릴 수 있습니다. 레지스트리 노드는 [세미틱 버전 관리](https://semver.org/)를 사용하므로, 사용자는 자신의 행동이 워크플로우에 어떤 영향을 미칠지 미리 알고 안전하게 업그레이드하거나, 오래된 버전을 폐기하거나, 고정할 수 있습니다. 워크플로우 JSON에는 사용된 노드의 버전이 저장되므로 언제나 안정적으로 워크플로우를 재현할 수 있습니다.   **노드 보안:** 레지스트리는 [ComfyUI-Manager](https://github.com/Comfy-Org/ComfyUI-Manager)의 백엔드 역할을 수행합니다. 모든 노드는 악성 행위, 예를 들어 맞춤형 pip wheel이나 임의의 시스템 호출 등이 있는지 검사됩니다. 이러한 검사를 통과한 노드는 UI-Manager의 이름 옆에 확인 표시()가 표시됩니다. 보안 기준 목록은 [기준](/registry/standards)을 참조하세요. @@ -26,18 +26,18 @@ Comfy 레지스트리는 맞춤형 노드 개발을 표준화함으로써 커뮤 - 네, 레지스트리의 맞춤형 노드는 전 세계적으로 고유한 이름을 가지며, 이를 통해 Comfy 워크플로우 JSON 파일은 중복 없이 어떤 맞춤형 노드든 고유하게 식별할 수 있습니다. + 네, 레지스트리의 커스텀 노드는 전 세계적으로 고유한 이름을 가지며, 이를 통해 Comfy 워크플로우 JSON 파일은 중복 없이 어떤 커스텀 노드든 고유하게 식별할 수 있습니다. 더 자세한 정보는 [기준](/registry/standards)을 확인하세요. - 맞춤형 노드의 버전이 한번 출시되면 변경될 수 없습니다. 이는 사용자가 시간이 지나도 맞춤형 노드의 안정성을 신뢰할 수 있도록 보장합니다. + 커스텀 노드의 버전이 한번 출시되면 변경될 수 없습니다. 이는 사용자가 시간이 지나도 커스텀 노드의 안정성을 신뢰할 수 있도록 보장합니다. - 맞춤형 노드는 [세미틱 버전 관리](https://semver.org/) 방식으로 버전 관리됩니다. 이를 통해 사용자는 새로운 버전으로 업그레이드했을 때의 영향을 쉽게 이해할 수 있습니다. + 커스텀 노드는 [세미틱 버전 관리](https://semver.org/) 방식으로 버전 관리됩니다. 이를 통해 사용자는 새로운 버전으로 업그레이드했을 때의 영향을 쉽게 이해할 수 있습니다. diff --git a/ko/registry/specifications.mdx b/ko/registry/specifications.mdx index 80b570e6a..3882d7134 100644 --- a/ko/registry/specifications.mdx +++ b/ko/registry/specifications.mdx @@ -6,12 +6,12 @@ translationFrom: registry/specifications.mdx # 사양 -`pyproject.toml` 파일에는 ComfyUI 맞춤형 노드를 위한 두 가지 주요 섹션이 포함되어 있습니다: `[project]`와 `[tool.comfy]`. 아래는 각 섹션의 사양입니다. +`pyproject.toml` 파일에는 ComfyUI 커스텀 노드를 위한 두 가지 주요 섹션이 포함되어 있습니다: `[project]`와 `[tool.comfy]`. 아래는 각 섹션의 사양입니다. ## [project] 섹션 ### name (필수) -노드 ID는 맞춤형 노드를 고유하게 식별하며, 레지스트리의 URL에서 사용됩니다. 사용자는 이 이름을 참조하여 노드를 설치할 수 있습니다: +노드 ID는 커스텀 노드를 고유하게 식별하며, 레지스트리의 URL에서 사용됩니다. 사용자는 이 이름을 참조하여 노드를 설치할 수 있습니다: ```bash comfy node install @@ -55,7 +55,7 @@ version = "2.0.0" # 중대한 변경사항 ``` ### license (선택적) -맞춤형 노드의 라이선스를 지정합니다. 두 가지 방식으로 지정할 수 있습니다: +커스텀 노드의 라이선스를 지정합니다. 두 가지 방식으로 지정할 수 있습니다: 1. **파일 참조:** ```toml @@ -74,7 +74,7 @@ license = "MIT LICENSE" # ❌ 형식 오류 공통 라이선스: [MIT](https://opensource.org/license/mit), [GPL](https://www.gnu.org/licenses/gpl-3.0.en.html), [Apache](https://www.apache.org/licenses/LICENSE-2.0) ### description (권장) -맞춤형 노드가 하는 일을 간략히 설명합니다. +커스텀 노드가 하는 일을 간략히 설명합니다. ```toml description = "이미지 품질을 향상시키기 위한 초해상도 노드" @@ -109,7 +109,7 @@ requires-python = ">=3.8,<3.11" # 파이썬 3.8부터 3.11까지 노드가 특정 ComfyUI 프론트엔드 버전을 요구하는 경우, `comfyui-frontend-package` 종속성을 사용해 이를 지정할 수 있습니다. 이 패키지는 [PyPI](https://pypi.org/project/comfyui-frontend-package/)에 게시됩니다. 예를 들어 다음 경우에 이 필드를 사용하세요: -- 맞춤형 노드가 특정 버전에서 도입된 프론트엔드 API를 사용하는 경우 +- 커스텀 노드가 특정 버전에서 도입된 프론트엔드 API를 사용하는 경우 - 노드와 특정 프론트엔드 버전 간의 호환성 문제가 발견된 경우 - 노드가 최신 프론트엔드 버전에서만 제공되는 특정 UI 기능을 필요로 하는 경우 @@ -159,14 +159,14 @@ PublisherId = "image-wizard" # ✅ 고유한 식별자 ``` ### DisplayName (선택적) -맞춤형 노드의 사용자 친화적인 이름입니다. +커스텀 노드의 사용자 친화적인 이름입니다. ```toml DisplayName = "초해상도 노드" ``` ### Icon (선택적) -ComfyUI 레지스트리와 ComfyUI-Manager에 표시될 맞춤형 노드 아이콘의 URL입니다. +ComfyUI 레지스트리와 ComfyUI-Manager에 표시될 커스텀 노드 아이콘의 URL입니다. **요구사항:** - 파일 형식: SVG, PNG, JPG, GIF @@ -202,7 +202,7 @@ requires-comfyui = ">0.1.3,<1.0.0" # 0.1.3보다 크고 1.0.0보다 작은 버 ``` ### includes (선택적) -특정 폴더를 강제로 포함할지 여부를 지정합니다. 일부 상황에서는 프론트엔드 프로젝트의 맞춤형 노드와 같이 최종 패키징 출력 폴더가 .gitignore에 포함될 수 있습니다. 이런 경우 레지스트리 사용을 위해 강제로 포함해야 합니다. +특정 폴더를 강제로 포함할지 여부를 지정합니다. 일부 상황에서는 프론트엔드 프로젝트의 커스텀 노드와 같이 최종 패키징 출력 폴더가 .gitignore에 포함될 수 있습니다. 이런 경우 레지스트리 사용을 위해 강제로 포함해야 합니다. ```toml includes = ['dist'] diff --git a/ko/troubleshooting/custom-node-issues.mdx b/ko/troubleshooting/custom-node-issues.mdx index e487f577c..acc2467bd 100644 --- a/ko/troubleshooting/custom-node-issues.mdx +++ b/ko/troubleshooting/custom-node-issues.mdx @@ -1,20 +1,20 @@ --- title: "ComfyUI 문제 해결 및 해결 방법" -description: "맞춤형 노드와 확장 기능으로 인한 문제를 해결하고 고치세요" +description: "커스텀 노드와 확장 기능으로 인한 문제를 해결하고 고치세요" icon: "puzzle-piece" -sidebarTitle: "맞춤형 노드 문제" +sidebarTitle: "커스텀 노드 문제" translationSourceHash: cbe9584d translationFrom: troubleshooting/custom-node-issues.mdx --- -다음은 맞춤형 노드 문제를 해결하기 위한 전반적인 접근법입니다: +다음은 커스텀 노드 문제를 해결하기 위한 전반적인 접근법입니다: ```mermaid flowchart TD - A[문제 발생] --> B{모든 맞춤형 노드를 비활성화한 후에도 문제가 사라지나요??} - B -- 예 --> C[맞춤형 노드가 원인인 문제] - B -- 아니요 --> D[맞춤형 노드가 원인이 아닌 문제, 다른 문제 해결 문서 참조] + A[문제 발생] --> B{모든 커스텀 노드를 비활성화한 후에도 문제가 사라지나요??} + B -- 예 --> C[커스텀 노드가 원인인 문제] + B -- 아니요 --> D[커스텀 노드가 원인이 아닌 문제, 다른 문제 해결 문서 참조] C --> E{먼저 프론트엔드 확장 기능을 확인하세요?} E -- 예 --> F[ComfyUI 프론트엔드에서 문제 해결
  • 프론트엔드만 다시 로드하면 됩니다
    • ] E -- 아니요 --> G[일반적인 이진 탐색 방법 사용
  • ComfyUI를 여러 번 재시작해야 합니다
    • ] @@ -24,12 +24,12 @@ flowchart TD I --> J[문제 해결됨] ``` -## 모든 맞춤형 노드를 비활성화하는 방법? +## 모든 커스텀 노드를 비활성화하는 방법? -설정 메뉴에서 맞춤형 노드를 비활성화한 상태로 ComfyUI 데스크탑을 시작하세요 -![설정 메뉴 - 맞춤형 노드 비활성화](/images/troubleshooting/desktop-diable-custom-node.jpg) +설정 메뉴에서 커스텀 노드를 비활성화한 상태로 ComfyUI 데스크탑을 시작하세요 +![설정 메뉴 - 커스텀 노드 비활성화](/images/troubleshooting/desktop-diable-custom-node.jpg) 또는 서버를 수동으로 실행하세요: ```bash cd path/to/your/comfyui @@ -55,7 +55,7 @@ python main.py --disable-all-custom-nodes pause ``` 4. 파일을 저장하고 닫으세요 - 5. 파일을 더블클릭해 실행하세요. 정상적으로 작동한다면 ComfyUI가 시작되고 맞춤형 노드가 비활성화된 것을 확인할 수 있습니다 + 5. 파일을 더블클릭해 실행하세요. 정상적으로 작동한다면 ComfyUI가 시작되고 커스텀 노드가 비활성화된 것을 확인할 수 있습니다 ![ComfyUI 문제 해결](/images/troubleshooting/portable-disable-custom-nodes-cml-1.jpg) @@ -63,7 +63,7 @@ python main.py --disable-all-custom-nodes 2. 마우스 오른쪽 클릭 → 터미널 열기를 통해 터미널을 엽니다 ![ComfyUI 문제 해결](/images/troubleshooting/portable-disable-custom-nodes-cml-2.jpg) 3. 폴더 이름이 현재 휴대용 버전의 디렉토리인지 확인하세요 - 4. 다음 명령어를 입력해 휴대용 파이썬을 통해 ComfyUI를 시작하고 맞춤형 노드를 비활성화하세요 + 4. 다음 명령어를 입력해 휴대용 파이썬을 통해 ComfyUI를 시작하고 커스텀 노드를 비활성화하세요 ``` .\python_embeded\python.exe -s ComfyUI\main.py --disable-all-custom-nodes ``` @@ -73,25 +73,25 @@ python main.py --disable-all-custom-nodes **결과:** -- ✅ **문제 사라짐**: 맞춤형 노드가 문제를 일으키고 있음 → 2단계로 진행 -- ❌ **문제 지속**: 맞춤형 노드 문제가 아님 → [문제 보고](#reporting-issues) +- ✅ **문제 사라짐**: 커스텀 노드가 문제를 일으키고 있음 → 2단계로 진행 +- ❌ **문제 지속**: 커스텀 노드 문제가 아님 → [문제 보고](#reporting-issues) ## 이진 탐색이란? -이 문서에서는 맞춤형 노드 문제 해결을 위한 이진 탐색 방식을 소개합니다. 이 방식은 맞춤형 노드를 두 개씩 나누어 절반씩 검사하며 문제 노드를 찾아가는 것입니다. +이 문서에서는 커스텀 노드 문제 해결을 위한 이진 탐색 방식을 소개합니다. 이 방식은 커스텀 노드를 두 개씩 나누어 절반씩 검사하며 문제 노드를 찾아가는 것입니다. -구체적인 방법은 아래 플로차트를 참고하세요 - 현재 비활성화된 노드 중 절반을 활성화하고 문제가 나타나는지 확인하며, 어느 맞춤형 노드가 문제를 일으키는지 찾아갑니다. +구체적인 방법은 아래 플로차트를 참고하세요 - 현재 비활성화된 노드 중 절반을 활성화하고 문제가 나타나는지 확인하며, 어느 커스텀 노드가 문제를 일으키는지 찾아갑니다. ```mermaid flowchart TD - A[시작] --> B{모든 맞춤형 노드를 반으로 나누기} - B --> C[첫 번째 절반의 맞춤형 노드 활성화] + A[시작] --> B{모든 커스텀 노드를 반으로 나누기} + B --> C[첫 번째 절반의 커스텀 노드 활성화] C --> D[ComfyUI 재시작하고 테스트] D --> E{문제가 나타나나요?} - E --> |예| F[문제는 활성화된 맞춤형 노드에 있음] - E --> |아니요| G[문제는 비활성화된 맞춤형 노드에 있음] - F --> H{활성화된 맞춤형 노드 > 1개?} - G --> I{비활성화된 맞춤형 노드 > 1개?} + E --> |예| F[문제는 활성화된 커스텀 노드에 있음] + E --> |아니요| G[문제는 비활성화된 커스텀 노드에 있음] + F --> H{활성화된 커스텀 노드 > 1개?} + G --> I{비활성화된 커스텀 노드 > 1개?} H --> |예| J[활성화된 노드에서 이진 탐색 계속] I --> |예| K[비활성화된 노드에서 이진 탐색 계속] H --> |아니요| L[문제 노드 발견] @@ -103,17 +103,17 @@ flowchart TD ## 두 가지 문제 해결 방법 -이 문서에서는 맞춤형 노드를 두 가지 유형으로 구분해 문제 해결을 안내합니다: +이 문서에서는 커스텀 노드를 두 가지 유형으로 구분해 문제 해결을 안내합니다: -![맞춤형 노드 유형](/images/troubleshooting/custom_node_type.jpg) -- A: 프론트엔드 확장 기능이 있는 맞춤형 노드 -- B: 일반 맞춤형 노드 +![커스텀 노드 유형](/images/troubleshooting/custom_node_type.jpg) +- A: 프론트엔드 확장 기능이 있는 커스텀 노드 +- B: 일반 커스텀 노드 -먼저 각 유형의 맞춤형 노드가 가질 수 있는 문제와 원인을 알아보겠습니다: +먼저 각 유형의 커스텀 노드가 가질 수 있는 문제와 원인을 알아보겠습니다: - - 맞춤형 노드 중에서도 프론트엔드 확장 기능이 있는 노드를 우선적으로 문제 해결해야 합니다. 이들은 가장 많은 문제를 일으키며, 주로 ComfyUI 프론트엔드 버전 업데이트와의 호환성 문제로 인해 발생합니다. + + 커스텀 노드 중에서도 프론트엔드 확장 기능이 있는 노드를 우선적으로 문제 해결해야 합니다. 이들은 가장 많은 문제를 일으키며, 주로 ComfyUI 프론트엔드 버전 업데이트와의 호환성 문제로 인해 발생합니다. 일반적인 문제는 다음과 같습니다: - 워크플로 실행 불가 @@ -126,21 +126,21 @@ flowchart TD - 그 외 다수 이러한 문제의 일반적인 원인은 다음과 같습니다: - - 업데이트 과정에서 프론트엔드가 변경되었으나 맞춤형 노드가 아직 이를 따라가지 못한 경우 - - 작성자가 호환 가능한 버전을 출시했음에도 사용자가 ComfyUI를 업데이트하면서 맞춤형 노드도 동기화하지 않은 경우 - - 작성자가 유지보수를 중단해 맞춤형 노드 확장 기능과 ComfyUI 프론트엔드 간의 호환성이 깨진 경우 + - 업데이트 과정에서 프론트엔드가 변경되었으나 커스텀 노드가 아직 이를 따라가지 못한 경우 + - 작성자가 호환 가능한 버전을 출시했음에도 사용자가 ComfyUI를 업데이트하면서 커스텀 노드도 동기화하지 않은 경우 + - 작성자가 유지보수를 중단해 커스텀 노드 확장 기능과 ComfyUI 프론트엔드 간의 호환성이 깨진 경우 - - 문제가 맞춤형 노드의 프론트엔드 확장 기능 때문이 아니라면 종종 의존성 관련 문제가 발생합니다. 일반적인 문제는 다음과 같습니다: + + 문제가 커스텀 노드의 프론트엔드 확장 기능 때문이 아니라면 종종 의존성 관련 문제가 발생합니다. 일반적인 문제는 다음과 같습니다: - 콘솔/로그에 "불러오기 실패" 오류 - 설치 및 재시작 후에도 여전히 노드가 누락된 것으로 표시됨 - ComfyUI가 충돌하거나 시작되지 않음 - 그 외 다수 이러한 오류의 일반적인 원인은 다음과 같습니다: - - ComfyUI-Nunchaku와 같은 추가 wheel이 필요한 맞춤형 노드 - - 특정 의존성 버전(예: `torch==2.4.1`)을 사용하는 맞춤형 노드와 다른 플러그인들이 다른 버전(예: `torch>=2.4.2`)을 사용해 설치 후 충돌이 발생한 경우 + - ComfyUI-Nunchaku와 같은 추가 wheel이 필요한 커스텀 노드 + - 특정 의존성 버전(예: `torch==2.4.1`)을 사용하는 커스텀 노드와 다른 플러그인들이 다른 버전(예: `torch>=2.4.2`)을 사용해 설치 후 충돌이 발생한 경우 - 네트워크 문제로 인해 의존성 설치가 성공하지 못한 경우 문제가 파이썬 환경의 상호 의존성과 버전과 관련되어 있을 때는 문제 해결이 더욱 복잡해지고, 의존성 설치 및 제거 방법 등 파이썬 환경 관리에 대한 지식이 필요합니다. @@ -149,40 +149,40 @@ flowchart TD ## 이진 탐색을 이용한 문제 해결 -위 두 가지 유형의 맞춤형 노드 문제 중에서도 맞춤형 노드 프론트엔드 확장 기능과 ComfyUI 간의 충돌이 더 흔하게 발생합니다. 우리는 먼저 이 노드들을 우선적으로 문제 해결하겠습니다. 전체적인 문제 해결 방식은 다음과 같습니다: +위 두 가지 유형의 커스텀 노드 문제 중에서도 커스텀 노드 프론트엔드 확장 기능과 ComfyUI 간의 충돌이 더 흔하게 발생합니다. 우리는 먼저 이 노드들을 우선적으로 문제 해결하겠습니다. 전체적인 문제 해결 방식은 다음과 같습니다: -### 1. 맞춤형 노드의 프론트엔드 확장 기능 문제 해결 +### 1. 커스텀 노드의 프론트엔드 확장 기능 문제 해결 ![모든 플러그인 프론트엔드 확장 기능 비활성화](/images/troubleshooting/disable_3rd_party.jpg) ComfyUI를 시작한 후 설정에서 `Extensions` 메뉴를 찾아 이미지에 표시된 단계를 따라 모든 서드파티 확장 기능을 비활성화하세요 - ComfyUI 프론트엔드에 진입할 수 없다면 프론트엔드 확장 기능 문제 해결 부분을 건너뛰고 [일반 맞춤형 노드 문제 해결 방식](#2-general-custom-node-troubleshooting-approach)으로 넘어가세요 + ComfyUI 프론트엔드에 진입할 수 없다면 프론트엔드 확장 기능 문제 해결 부분을 건너뛰고 [일반 커스텀 노드 문제 해결 방식](#2-general-custom-node-troubleshooting-approach)으로 넘어가세요 첫 번째로 프론트엔드 확장 기능을 비활성화한 후, 모든 프론트엔드 확장 기능이 제대로 비활성화되었는지 확인하려면 ComfyUI를 재시작하는 것이 좋습니다 - - 문제가 사라졌다면 맞춤형 노드 프론트엔드 확장 기능이 원인이므로 이진 탐색을 통해 문제를 해결할 수 있습니다 + - 문제가 사라졌다면 커스텀 노드 프론트엔드 확장 기능이 원인이므로 이진 탐색을 통해 문제를 해결할 수 있습니다 - 문제가 지속된다면 프론트엔드 확장 기능이 원인이 아닙니다 - 이 문서의 다른 문제 해결 방식을 참고하세요 - 이 문서 앞부분에서 언급한 방법을 사용해 문제 노드를 찾으세요. 한 번에 맞춤형 노드의 절반을 활성화하며 문제가 되는 노드를 찾아갑니다 + 이 문서 앞부분에서 언급한 방법을 사용해 문제 노드를 찾으세요. 한 번에 커스텀 노드의 절반을 활성화하며 문제가 되는 노드를 찾아갑니다 ![프론트엔드 확장 기능 활성화](/images/troubleshooting/enable_extensions.jpg) - 이미지를 참고해 프론트엔드 확장 기능의 절반을 활성화하세요. 확장 기능 이름이 비슷하다면 대부분 같은 맞춤형 노드의 프론트엔드 확장 기능임을 의미합니다 + 이미지를 참고해 프론트엔드 확장 기능의 절반을 활성화하세요. 확장 기능 이름이 비슷하다면 대부분 같은 커스텀 노드의 프론트엔드 확장 기능임을 의미합니다 - 문제가 되는 맞춤형 노드를 찾았다면 이 문서의 문제 해결 섹션을 참고해 맞춤형 노드 문제를 해결하세요 + 문제가 되는 커스텀 노드를 찾았다면 이 문서의 문제 해결 섹션을 참고해 커스텀 노드 문제를 해결하세요 -이 방법을 사용하면 ComfyUI를 여러 번 재시작할 필요가 없습니다 - 맞춤형 노드 프론트엔드 확장 기능을 활성화하거나 비활성화한 후 ComfyUI를 다시 로드하기만 하면 됩니다. 또한 문제 해결 범위가 프론트엔드 확장 기능이 있는 노드로 한정되므로 검색 범위가 크게 줄어듭니다. +이 방법을 사용하면 ComfyUI를 여러 번 재시작할 필요가 없습니다 - 커스텀 노드 프론트엔드 확장 기능을 활성화하거나 비활성화한 후 ComfyUI를 다시 로드하기만 하면 됩니다. 또한 문제 해결 범위가 프론트엔드 확장 기능이 있는 노드로 한정되므로 검색 범위가 크게 줄어듭니다. -### 2. 일반 맞춤형 노드 문제 해결 +### 2. 일반 커스텀 노드 문제 해결 - + 이진 탐색을 이용한 위치 파악 방법에는 수동 검색 외에도 아래와 같이 comfy-cli를 이용한 자동 이진 탐색도 가능합니다: @@ -220,7 +220,7 @@ flowchart TD 시작하기 전에 `\ComfyUI\` 폴더로 들어가세요 - - **모든 맞춤형 노드 백업**: `custom_nodes`를 복사해 `custom_nodes_backup`으로 이름 변경 + - **모든 커스텀 노드 백업**: `custom_nodes`를 복사해 `custom_nodes_backup`으로 이름 변경 - **임시 폴더 생성**: `custom_nodes_temp`라는 폴더를 생성하세요 또는 다음 명령어를 사용해 백업하세요: @@ -258,7 +258,7 @@ flowchart TD - + Windows는 시각적 인터페이스를 제공하므로 명령줄만 사용하는 경우가 아니라면 이 단계를 생략해도 됩니다 @@ -279,7 +279,7 @@ flowchart TD - 8개의 맞춤형 노드가 있다고 가정해봅시다. 첫 번째 절반을 임시 저장소로 옮기세요: + 8개의 커스텀 노드가 있다고 가정해봅시다. 첫 번째 절반을 임시 저장소로 옮기세요: ```bash @@ -342,11 +342,11 @@ flowchart TD 2. 노드를 업데이트하고 다시 테스트하세요 ### 옵션 2: 노드 교체 -1. 비슷한 기능을 가진 대체 맞춤형 노드를 찾아보세요 +1. 비슷한 기능을 가진 대체 커스텀 노드를 찾아보세요 2. [ComfyUI 레지스트리](https://registry.comfy.org)에서 대체품을 확인하세요 ### 옵션 3: 문제 보고 -맞춤형 노드 개발자에게 연락하세요: +커스텀 노드 개발자에게 연락하세요: 1. 노드의 GitHub 리포지토리를 찾아보세요 2. 다음 정보를 포함해 이슈를 생성하세요: - ComfyUI 버전 @@ -361,10 +361,10 @@ flowchart TD ## 문제 보고 -맞춤형 노드가 원인이 아닌 문제라면 일반적인 [문제 해결 개요](/troubleshooting/overview)를 참고해 다른 공통 문제를 해결하세요. +커스텀 노드가 원인이 아닌 문제라면 일반적인 [문제 해결 개요](/troubleshooting/overview)를 참고해 다른 공통 문제를 해결하세요. -### 맞춤형 노드 특별 문제 -맞춤형 노드 개발자에게 연락하세요: +### 커스텀 노드 특별 문제 +커스텀 노드 개발자에게 연락하세요: - 노드의 GitHub 리포지토리를 찾아보세요 - ComfyUI 버전, 오류 메시지, 재현 단계, 운영체제를 포함해 이슈를 생성하세요 - 노드의 문서와 이슈 페이지에서 이미 알려진 문제를 확인하세요 diff --git a/ko/troubleshooting/overview.mdx b/ko/troubleshooting/overview.mdx index 2de003d85..743612291 100644 --- a/ko/troubleshooting/overview.mdx +++ b/ko/troubleshooting/overview.mdx @@ -8,11 +8,11 @@ translationFrom: troubleshooting/overview.mdx --- - 우리는 많은 피드백 이슈를 받고 있으며, 제출된 대부분의 이슈가 맞춤형 노드와 관련되어 있음을 발견했습니다. 따라서 오류 보고서를 제출하기 전에 [맞춤형 노드 문제 해결 가이드](/troubleshooting/custom-node-issues)를 반드시 읽어보시기 바랍니다. 이렇게 하면 문제가 ComfyUI 핵심 문제로 인한 것이 아닌지 확인할 수 있습니다. + 우리는 많은 피드백 이슈를 받고 있으며, 제출된 대부분의 이슈가 커스텀 노드와 관련되어 있음을 발견했습니다. 따라서 오류 보고서를 제출하기 전에 [커스텀 노드 문제 해결 가이드](/troubleshooting/custom-node-issues)를 반드시 읽어보시기 바랍니다. 이렇게 하면 문제가 ComfyUI 핵심 문제로 인한 것이 아닌지 확인할 수 있습니다. - - 맞춤형 노드로 인한 문제를 어떻게 해결하는지 확인하세요. + + 커스텀 노드로 인한 문제를 어떻게 해결하는지 확인하세요. ## 일반적인 문제 및 빠른 해결 방법 @@ -33,7 +33,7 @@ translationFrom: troubleshooting/overview.mdx **빠른 해결 방법:** 1. **"보고서 표시" 클릭** - 자세한 오류 메시지를 읽어 특정 문제를 파악하세요. -2. **맞춤형 노드 문제인지 확인** - [맞춤형 노드 문제 해결 가이드](/troubleshooting/custom-node-issues)를 따르세요. +2. **커스텀 노드 문제인지 확인** - [커스텀 노드 문제 해결 가이드](/troubleshooting/custom-node-issues)를 따르세요. 3. **모델 파일 확인** - 모델 설정은 [모델 문서](/development/core-concepts/models)를 참조하세요. 4. **VRAM 사용량 확인** - GPU 메모리를 사용하는 다른 애플리케이션을 종료하세요. @@ -245,7 +245,7 @@ python -c "import torch; print('CUDA available:', torch.cuda.is_available()); pr pip install -r requirements.txt ``` -**"맞춤형 노드를 찾을 수 없습니다":** +**"커스텀 노드를 찾을 수 없습니다":** - ComfyUI 설정에서 노드 검증을 비활성화하세요. **"워크플로우 검증 실패에 대한 오류 알림":** @@ -367,7 +367,7 @@ pip install torch==2.3.1.post0+cxx11.abi torchvision==0.18.1.post0+cxx11.abi tor 2. **기본 문제 해결 시도:** - [기본 워크플로우](/get_started/first_generation)로 테스트 - - 모든 맞춤형 노드 비활성화 (맞춤형 노드 문제 해결 참고) + - 모든 커스텀 노드 비활성화 (커스텀 노드 문제 해결 참고) - 콘솔/터미널에서 오류 메시지를 확인 - comfy-cli 사용 시 `comfy node update all`로 업데이트 시도 @@ -382,8 +382,8 @@ pip install torch==2.3.1.post0+cxx11.abi torchvision==0.18.1.post0+cxx11.abi tor #### 프론트엔드 문제 **보내는 곳:** [프론트엔드 GitHub 이슈](https://github.com/Comfy-Org/ComfyUI_frontend/issues) -#### 맞춤형 노드 문제 -**보내는 곳:** 특정 맞춤형 노드 개발자에게 문의 +#### 커스텀 노드 문제 +**보내는 곳:** 특정 커스텀 노드 개발자에게 문의 ### 필수 정보 @@ -460,7 +460,7 @@ pip install torch==2.3.1.post0+cxx11.abi torchvision==0.18.1.post0+cxx11.abi tor **추가 상황:** -- 설치된 맞춤형 노드 목록 +- 설치된 커스텀 노드 목록 - 문제를 재현하는 워크플로우 파일 (.json) - 최근 변경사항 (새로운 설치, 업데이트 등) diff --git a/ko/tutorials/3d/hunyuan3D-2.mdx b/ko/tutorials/3d/hunyuan3D-2.mdx index 6ef26a2e3..96e323f13 100644 --- a/ko/tutorials/3d/hunyuan3D-2.mdx +++ b/ko/tutorials/3d/hunyuan3D-2.mdx @@ -66,7 +66,7 @@ Hunyuan3D-2mv 워크플로우에서는 다중뷰 이미지를 사용해 3D 모 -이 예시에서 사용된 입력 이미지는 이미 사전 처리되어 불필요한 배경이 제거되었습니다. 실제 사용 시, [ComfyUI_essentials](https://github.com/cubiq/ComfyUI_essentials)와 같은 맞춤 노드를 사용해 자동으로 불필요한 배경을 제거할 수 있습니다. +이 예시에서 사용된 입력 이미지는 이미 사전 처리되어 불필요한 배경이 제거되었습니다. 실제 사용 시, [ComfyUI_essentials](https://github.com/cubiq/ComfyUI_essentials)와 같은 커스텀 노드를 사용해 자동으로 불필요한 배경을 제거할 수 있습니다. ### 2. 수동 모델 설치 diff --git a/ko/tutorials/audio/stable-audio/stable-audio-1.mdx b/ko/tutorials/audio/stable-audio/stable-audio-1.mdx index 7565153a9..548f6c17f 100644 --- a/ko/tutorials/audio/stable-audio/stable-audio-1.mdx +++ b/ko/tutorials/audio/stable-audio/stable-audio-1.mdx @@ -27,7 +27,7 @@ import UpdateReminder from "/snippets/ko/tutorials/update-reminder.mdx" ![Stable Audio 1.0 워크플로우](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/audio_stable_audio_example-1.webp) -이 워크플로우는 **표준 ComfyUI 노드**만 사용하며, 맞춤형 노드는 필요하지 않습니다. Stable Audio 1.0 체크포인트를 로드하고, CLIP 텍스트 인코더(t5-base)를 통해 프롬프트를 인코딩한 후 KSampler로 잠재적 오디오를 노이즈 제거하고, 모델의 VAE를 통해 오디오로 디코드합니다. +이 워크플로우는 **표준 ComfyUI 노드**만 사용하며, 커스텀 노드는 필요하지 않습니다. Stable Audio 1.0 체크포인트를 로드하고, CLIP 텍스트 인코더(t5-base)를 통해 프롬프트를 인코딩한 후 KSampler로 잠재적 오디오를 노이즈 제거하고, 모델의 VAE를 통해 오디오로 디코드합니다. **사용 방법**: 1. **체크포인트 로드하기** — `CheckpointLoaderSimple` 노드는 `stable-audio-open-1.0.safetensors`를 사용합니다. diff --git a/ko/tutorials/controlnet/controlnet.mdx b/ko/tutorials/controlnet/controlnet.mdx index d4b9b3a8c..55d7a6985 100644 --- a/ko/tutorials/controlnet/controlnet.mdx +++ b/ko/tutorials/controlnet/controlnet.mdx @@ -38,7 +38,7 @@ ControlNet의 등장으로 우리는 추가적인 조건을 도입해 이미지 > 이미지 출처: [ComfyUI ControlNet aux](https://github.com/Fannovel16/comfyui_controlnet_aux) -현재 **Comfy Core** 노드에는 모든 종류의 **프리프로세서**가 포함되어 있지 않으므로, 이 문서의 실제 예시에서는 미리 처리된 이미지를 제공합니다. 하지만 실제 사용 시에는 맞춤형 노드를 사용해 이미지를 전처리하여 다양한 ControlNet 모델의 요구사항을 충족해야 할 수 있습니다. 아래는 관련된 일부 맞춤형 노드입니다: +현재 **Comfy Core** 노드에는 모든 종류의 **프리프로세서**가 포함되어 있지 않으므로, 이 문서의 실제 예시에서는 미리 처리된 이미지를 제공합니다. 하지만 실제 사용 시에는 커스텀 노드를 사용해 이미지를 전처리하여 다양한 ControlNet 모델의 요구사항을 충족해야 할 수 있습니다. 아래는 관련된 일부 커스텀 노드입니다: - [ComfyUI-Advanced-ControlNet](https://github.com/Kosinkadink/ComfyUI-Advanced-ControlNet) - [ComfyUI ControlNet aux](https://github.com/Fannovel16/comfyui_controlnet_aux) diff --git a/ko/tutorials/flux/flux-1-controlnet.mdx b/ko/tutorials/flux/flux-1-controlnet.mdx index 212ac948d..239844958 100644 --- a/ko/tutorials/flux/flux-1-controlnet.mdx +++ b/ko/tutorials/flux/flux-1-controlnet.mdx @@ -35,7 +35,7 @@ Depth 버전은 깊이 맵 추출 기법을 통해 원본 이미지의 공간적 데스크톱 버전을 사용하지 않거나 일부 모델이 자동으로 다운로드되지 않는 경우, 수동 설치 섹션을 참고해 모델 파일을 해당 폴더에 저장하세요. -이미지 전처리기를 사용하려면 다음 맞춤 노드를 사용해 이미지 전처리를 완료할 수 있습니다. 이번 예제에서는 처리된 이미지를 입력으로 제공하겠습니다. +이미지 전처리기를 사용하려면 다음 커스텀 노드를 사용해 이미지 전처리를 완료할 수 있습니다. 이번 예제에서는 처리된 이미지를 입력으로 제공하겠습니다. - [ComfyUI-Advanced-ControlNet](https://github.com/Kosinkadink/ComfyUI-Advanced-ControlNet) - [ComfyUI ControlNet aux](https://github.com/Fannovel16/comfyui_controlnet_aux) @@ -103,7 +103,7 @@ ComfyUI/ 아래 이미지를 입력으로 사용할 수 있습니다. ![ComfyUI 실내 깊이 맵](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/controlnet/depth-t2i-adapter_input.png) -또는 다음 맞춤 노드를 사용해 이미지 전처리를 완료하세요: +또는 다음 커스텀 노드를 사용해 이미지 전처리를 완료하세요: - [ComfyUI-Advanced-ControlNet](https://github.com/Kosinkadink/ComfyUI-Advanced-ControlNet) - [ComfyUI ControlNet aux](https://github.com/Fannovel16/comfyui_controlnet_aux) diff --git a/ko/tutorials/image/qwen/qwen-image.mdx b/ko/tutorials/image/qwen/qwen-image.mdx index 8a69a8aba..491c6c974 100644 --- a/ko/tutorials/image/qwen/qwen-image.mdx +++ b/ko/tutorials/image/qwen/qwen-image.mdx @@ -199,7 +199,7 @@ ComfyUI/ │ └── lvae-ft-mse-840000-ema-pruned.safetensors ``` -> [comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux)와 같은 맞춤형 노드를 사용해 깊이맵을 생성할 수도 있습니다. +> [comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux)와 같은 커스텀 노드를 사용해 깊이맵을 생성할 수도 있습니다. ### 3. 워크플로우 지침 diff --git a/ko/tutorials/llm/qwen/qwen3.mdx b/ko/tutorials/llm/qwen/qwen3.mdx index a049b77a3..4d7335c1e 100644 --- a/ko/tutorials/llm/qwen/qwen3.mdx +++ b/ko/tutorials/llm/qwen/qwen3.mdx @@ -16,7 +16,7 @@ import UpdateReminder from '/snippets/ko/tutorials/update-reminder.mdx' - **강력한 추론** — Qwen3-4B-Thinking은 단계별 사고 체인 추론을 지원합니다. - **텍스트 생성 중심** — 구조화된 텍스트 출력, 분석 및 코딩 작업에 최적화되어 있습니다. -- **ComfyUI 기본 지원** — 내장된 `TextGenerate` 노드와 함께 작동하며, 맞춤형 노드가 필요하지 않습니다. +- **ComfyUI 기본 지원** — 내장된 `TextGenerate` 노드와 함께 작동하며, 커스텀 노드가 필요하지 않습니다. - **경량성** — Qwen3.5와 동일한 텍스트 인코더 형식을 공유하며, 2B, 4B 및 9B 변형으로 제공되어 다양한 하드웨어에 맞게 사용할 수 있습니다. diff --git a/ko/tutorials/llm/qwen/qwen3_5.mdx b/ko/tutorials/llm/qwen/qwen3_5.mdx index aec9e0767..18a0c8f14 100644 --- a/ko/tutorials/llm/qwen/qwen3_5.mdx +++ b/ko/tutorials/llm/qwen/qwen3_5.mdx @@ -17,7 +17,7 @@ import UpdateReminder from "/snippets/ko/tutorials/update-reminder.mdx" - **다모달** — 시각적 이해 작업을 위해 텍스트와 이미지 입력을 모두 수용합니다. - **이미지 캡션** — 이미지를 설명하고 상세한 캡션을 생성할 수 있습니다. - **리버스 프롬프트 엔지니어링** — 참조 이미지에서 프롬프트와 생성 파라미터를 추출합니다. -- **ComfyUI 기본 제공** — 내장된 `TextGenerate` 노드와 함께 작동하며, 맞춤형 노드가 필요하지 않습니다. +- **ComfyUI 기본 제공** — 내장된 `TextGenerate` 노드와 함께 작동하며, 커스텀 노드가 필요하지 않습니다. - **경량성** — 4B 파라미터 모델로, 소비자용 GPU에 적합합니다. diff --git a/ko/tutorials/utility/frame-interpolation.mdx b/ko/tutorials/utility/frame-interpolation.mdx index 075fcf261..ec509aa1c 100644 --- a/ko/tutorials/utility/frame-interpolation.mdx +++ b/ko/tutorials/utility/frame-interpolation.mdx @@ -9,7 +9,7 @@ translationFrom: tutorials/utility/frame-interpolation.mdx ## 프레임 보간이란 무엇인가요? -이 워크플로우에는 맞춤형 노드가 포함되어 있습니다. 워크플로우를 실행하기 전에 [ComfyUI 매니저](/manager/overview)를 사용해 이를 설치해야 합니다. +이 워크플로우에는 커스텀 노드가 포함되어 있습니다. 워크플로우를 실행하기 전에 [ComfyUI 매니저](/manager/overview)를 사용해 이를 설치해야 합니다. 프레임 보간은 기존 프레임 사이에 중간 프레임을 생성하여 더 부드러운 모션과 향상된 시간적 일관성을 제공합니다. 이 기술은 비디오 후처리에 필수적이며, 생성된 비디오의 품질을 크게 개선할 수 있습니다. diff --git a/ko/tutorials/utility/preprocessors.mdx b/ko/tutorials/utility/preprocessors.mdx index bc9114e06..759ae1af6 100644 --- a/ko/tutorials/utility/preprocessors.mdx +++ b/ko/tutorials/utility/preprocessors.mdx @@ -9,7 +9,7 @@ translationFrom: tutorials/utility/preprocessors.mdx ## 전처리기란 무엇인가요? -이 워크플로우에는 맞춤형 노드가 포함되어 있습니다. 워크플로우를 실행하기 전에 [ComfyUI 관리자](/manager/overview)를 사용해 설치해야 합니다. +이 워크플로우에는 커스텀 노드가 포함되어 있습니다. 워크플로우를 실행하기 전에 [ComfyUI 관리자](/manager/overview)를 사용해 설치해야 합니다. 전처리기는 이미지에서 구조적 정보를 추출하는 기본 도구입니다. 이들은 이미지를 깊이 맵, 라인아트, 자세 골격, 표면 법선과 같은 조건 신호로 변환합니다. 이러한 출력은 ControlNet, 이미지-이미지 및 비디오 워크플로우에서 더 나은 제어와 일관성을 제공합니다. diff --git a/ko/tutorials/video/wan/fun-control.mdx b/ko/tutorials/video/wan/fun-control.mdx index 4dd4be01d..78c4a34a4 100644 --- a/ko/tutorials/video/wan/fun-control.mdx +++ b/ko/tutorials/video/wan/fun-control.mdx @@ -27,10 +27,10 @@ ComfyUI는 현재 Wan2.1 Fun Control 모델을 **네이티브로 지원**합니 이 가이드에서는 두 가지 워크플로우를 제공합니다: 1. 네이티브 Comfy Core 노드만을 사용하는 워크플로우 -2. 맞춤형 노드를 사용하는 워크플로우 +2. 커스텀 노드를 사용하는 워크플로우 -현재 영상 지원을 위한 네이티브 노드의 한계로 인해, 네이티브 전용 워크플로우는 사용자가 맞춤형 노드 설치 없이도 작업을 완료할 수 있도록 보장합니다. 하지만 맞춤형 노드 없이는 영상 생성 시 좋은 사용자 경험을 제공하기 어렵다는 점을 발견했으므로, 이 가이드에서는 두 가지 버전의 워크플로우를 모두 제공합니다. +현재 영상 지원을 위한 네이티브 노드의 한계로 인해, 네이티브 전용 워크플로우는 사용자가 커스텀 노드 설치 없이도 작업을 완료할 수 있도록 보장합니다. 하지만 커스텀 노드 없이는 영상 생성 시 좋은 사용자 경험을 제공하기 어렵다는 점을 발견했으므로, 이 가이드에서는 두 가지 버전의 워크플로우를 모두 제공합니다. @@ -73,9 +73,9 @@ ComfyUI는 현재 Wan2.1 Fun Control 모델을 **네이티브로 지원**합니 ## ComfyUI 네이티브 워크플로우 -이 워크플로우에서는 현재 `Load Image` 노드가 mp4 형식을 지원하지 않기 때문에 **WebP 형식**으로 변환된 영상을 사용합니다. 또한 원본 영상을 전처리하기 위해 **Canny Edge**를 사용합니다. 많은 사용자가 맞춤형 노드를 설치할 때 설치 실패와 환경 문제를 겪기 때문에, 이번 버전의 워크플로우는 오직 네이티브 노드만을 사용해 더욱 원활한 경험을 보장합니다. +이 워크플로우에서는 현재 `Load Image` 노드가 mp4 형식을 지원하지 않기 때문에 **WebP 형식**으로 변환된 영상을 사용합니다. 또한 원본 영상을 전처리하기 위해 **Canny Edge**를 사용합니다. 많은 사용자가 커스텀 노드를 설치할 때 설치 실패와 환경 문제를 겪기 때문에, 이번 버전의 워크플로우는 오직 네이티브 노드만을 사용해 더욱 원활한 경험을 보장합니다. -강력한 기능을 제공하는 ComfyUI 저자분들께 감사드립니다. 관련 버전을 직접 확인하고 싶다면 [맞춤형 노드를 사용한 워크플로우](#workflow-using-custom-nodes)를 참조하세요. +강력한 기능을 제공하는 ComfyUI 저자분들께 감사드립니다. 관련 버전을 직접 확인하고 싶다면 [커스텀 노드를 사용한 워크플로우](#workflow-using-custom-nodes)를 참조하세요. ### 1. 워크플로우 파일 다운로드 @@ -109,19 +109,19 @@ ComfyUI는 현재 Wan2.1 Fun Control 모델을 **네이티브로 지원**합니 ### 3. 사용 시 주의사항 -- `WanFunControlToVideo` 노드에 제어 영상과 같은 수의 프레임을 입력해야 하므로, 지정한 프레임 수가 실제 제어 영상 프레임보다 많으면 초과한 프레임은 제어 조건에 맞지 않는 장면이 표시될 수 있습니다. 이 문제는 [맞춤형 노드를 사용한 워크플로우](#workflow-using-custom-nodes)에서 해결하겠습니다. +- `WanFunControlToVideo` 노드에 제어 영상과 같은 수의 프레임을 입력해야 하므로, 지정한 프레임 수가 실제 제어 영상 프레임보다 많으면 초과한 프레임은 제어 조건에 맞지 않는 장면이 표시될 수 있습니다. 이 문제는 [커스텀 노드를 사용한 워크플로우](#workflow-using-custom-nodes)에서 해결하겠습니다. - 너무 큰 크기를 설정하지 마세요. 샘플링 과정이 매우 오래 걸릴 수 있습니다. 먼저 작은 이미지를 생성한 후 확대해보세요. - 이 워크플로우를 기반으로 상상력을 발휘해 텍스트-to-image나 다른 유형의 워크플로우를 추가해 직접 텍스트-to-video 생성이나 스타일 전송을 구현해보세요. - [ComfyUI-comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux)와 같은 도구를 사용해 더욱 풍부한 제어 옵션을 활용하세요. -## 맞춤형 노드를 사용한 워크플로우 +## 커스텀 노드를 사용한 워크플로우 -다음 두 가지 맞춤형 노드를 설치해야 합니다: +다음 두 가지 커스텀 노드를 설치해야 합니다: - [ComfyUI-VideoHelperSuite](https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite) - [ComfyUI-comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) -[ComfyUI Manager](https://github.com/Comfy-Org/ComfyUI-Manager)를 사용해 누락된 노드를 설치하거나 각 맞춤형 노드 패키지의 설치 지침을 따르세요. +[ComfyUI Manager](https://github.com/Comfy-Org/ComfyUI-Manager)를 사용해 누락된 노드를 설치하거나 각 커스텀 노드 패키지의 설치 지침을 따르세요. ### 1. 워크플로우 파일 다운로드 @@ -147,7 +147,7 @@ ComfyUI는 현재 Wan2.1 Fun Control 모델을 **네이티브로 지원**합니 ### 2. 워크플로우 단계별 완료 -![Wan2.1 Fun Control 맞춤형 노드 사용 워크플로우 단계](/images/tutorial/video/wan/fun_control_using_custom_nodes_flow_diagram.png) +![Wan2.1 Fun Control 커스텀 노드 사용 워크플로우 단계](/images/tutorial/video/wan/fun_control_using_custom_nodes_flow_diagram.png) > 모델 부분은 기본적으로 동일합니다. 이미 네이티브 전용 워크플로우를 경험했다면 해당 이미지를 바로 업로드해 실행할 수 있습니다. @@ -156,7 +156,7 @@ ComfyUI는 현재 Wan2.1 Fun Control 모델을 **네이티브로 지원**합니 3. `Load VAE` 노드가 `wan_2.1_vae.safetensors`를 로드했는지 확인하세요. 4. `Load CLIP Vision` 노드가 `clip_vision_h.safetensors`를 로드했는지 확인하세요. 5. 시작 프레임을 `Load Image` 노드에 업로드하세요. -6. mp4 형식의 영상을 `Load Video(Upload)` 맞춤형 노드에 업로드하세요. 참고: 워크플로우는 기본 `frame_load_cap`를 조정했습니다. +6. mp4 형식의 영상을 `Load Video(Upload)` 커스텀 노드에 업로드하세요. 참고: 워크플로우는 기본 `frame_load_cap`를 조정했습니다. 7. 현재 이미지의 경우 `DWPose Estimator`는 `detect_face` 옵션만 사용합니다. 8. (선택사항) 프롬프트를 수정하세요 (영어와 중국어 모두 지원). 9. (선택사항) `WanFunControlToVideo`에서 영상 크기를 조정해 너무 큰 크기를 피하세요. @@ -164,7 +164,7 @@ ComfyUI는 현재 Wan2.1 Fun Control 모델을 **네이티브로 지원**합니 ### 3. 워크플로우 참고사항 -ComfyUI 커뮤니티의 저자들이 제공하는 맞춤형 노드 패키지 덕분에: +ComfyUI 커뮤니티의 저자들이 제공하는 커스텀 노드 패키지 덕분에: - 이 예시에서는 `Load Video(Upload)`를 사용해 mp4 영상을 지원합니다. - `Load Video(Upload)`에서 얻은 `video_info`를 통해 출력 영상의 동일한 `fps`를 유지할 수 있습니다. - `DWPose Estimator`를 `ComfyUI-comfyui_controlnet_aux` 노드 패키지의 다른 전처리기로 교체할 수 있습니다. @@ -176,7 +176,7 @@ ComfyUI 커뮤니티의 저자들이 제공하는 맞춤형 노드 패키지 덕 - 유용한 팁은 여러 이미지 전처리 기법을 결합한 후 `Image Blend` 노드를 사용해 동시에 여러 제어 방법을 적용하는 목표를 달성할 수 있다는 것입니다. - `ComfyUI-VideoHelperSuite`의 `Video Combine` 노드를 사용해 영상을 mp4 형식으로 저장할 수 있습니다. -- 현재 워크플로우를 **mp4**에 내장하는 것을 지원하지 않으며, 일부 맞춤형 노드 역시 워크플로우 내장이 불가능할 수 있습니다. 영상에 워크플로우를 유지하려면 `SaveAnimatedWEBP` 노드를 선택합니다. +- 현재 워크플로우를 **mp4**에 내장하는 것을 지원하지 않으며, 일부 커스텀 노드 역시 워크플로우 내장이 불가능할 수 있습니다. 영상에 워크플로우를 유지하려면 `SaveAnimatedWEBP` 노드를 선택합니다. - `WanFunControlToVideo` 노드에서 `control_video`는 필수는 아니므로, 때때로 제어 영상을 생략하고 처음에 320x320처럼 아주 작은 영상을 생성한 후 이를 제어 영상 입력으로 사용해 일관된 결과를 얻을 수 있습니다. - [ComfyUI-WanVideoWrapper](https://github.com/kijai/ComfyUI-WanVideoWrapper) diff --git a/ko/tutorials/video/wan/fun-inp.mdx b/ko/tutorials/video/wan/fun-inp.mdx index 53075a85b..0ebea1068 100644 --- a/ko/tutorials/video/wan/fun-inp.mdx +++ b/ko/tutorials/video/wan/fun-inp.mdx @@ -96,7 +96,7 @@ import UpdateReminder from "/snippets/tutorials/update-reminder.mdx"; - Wan Fun InP를 사용할 때는 종종 프롬프트를 수정해 해당 장면 전환의 정확성을 보장해야 합니다. -## 기타 Wan2.1 Fun InP 또는 동영상 관련 맞춤형 노드 패키지 +## 기타 Wan2.1 Fun InP 또는 동영상 관련 커스텀 노드 패키지 - [ComfyUI-VideoHelperSuite](https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite) - [ComfyUI-WanVideoWrapper](https://github.com/kijai/ComfyUI-WanVideoWrapper) diff --git a/snippets/ko/install/desktop-resource-warning.mdx b/snippets/ko/install/desktop-resource-warning.mdx index 0100f35cc..ebcbf32b3 100644 --- a/snippets/ko/install/desktop-resource-warning.mdx +++ b/snippets/ko/install/desktop-resource-warning.mdx @@ -4,5 +4,5 @@ /resource/ComfyUI 폴더에 어떤 내용도 추가하거나 수정하지 마세요. ComfyUI 데스크톱이 업데이트될 때 이 폴더의 모든 내용이 초기화됩니다. -다른 ComfyUI 버전과 달리, 데스크톱 버전은 이 폴더를 자동으로 관리합니다. 설치 시 모델, 맞춤형 노드 및 기타 사용자 파일을 위한 사용자 지정 위치를 선택하셨으니, 그 위치를 사용해 주시기 바랍니다. +다른 ComfyUI 버전과 달리, 데스크톱 버전은 이 폴더를 자동으로 관리합니다. 설치 시 모델, 커스텀 노드 및 기타 사용자 파일을 위한 사용자 지정 위치를 선택하셨으니, 그 위치를 사용해 주시기 바랍니다. \ No newline at end of file diff --git a/snippets/ko/install/troubleshooting-feedback.mdx b/snippets/ko/install/troubleshooting-feedback.mdx index 3aae64b25..773cd6214 100644 --- a/snippets/ko/install/troubleshooting-feedback.mdx +++ b/snippets/ko/install/troubleshooting-feedback.mdx @@ -21,7 +21,7 @@ | 파일명 | 설명 | 위치 | |--------------------------|---------------------------------------------------------------------------------|-------------------| -| extra_model_paths.yaml | ComfyUI가 모델 및 맞춤형 노드를 검색할 추가 경로 포함 | {config_path} | +| extra_model_paths.yaml | ComfyUI가 모델 및 커스텀 노드를 검색할 추가 경로 포함 | {config_path} | | config.json | 애플리케이션 설정을 포함합니다. 이 파일은 직접 수정하지 마세요 | {config_path} | ![ComfyUI 구성 파일 위치](/images/desktop/win-comfyui-desktop-11-config.jpg) \ No newline at end of file