From e102e4b03a2c9380bd3ce5f3f579992efd1a3507 Mon Sep 17 00:00:00 2001 From: ComfyUI Wiki Date: Mon, 6 Jul 2026 09:08:01 +0800 Subject: [PATCH 1/6] docs: add Docker notice to system requirements and manual install Clarify that ComfyUI has no official Docker image and that images found on Docker Hub are community-maintained and unsupported. EN/ZH/JA/KO only. --- installation/manual_install.mdx | 4 ++++ installation/system_requirements.mdx | 3 +++ ja/installation/manual_install.mdx | 4 ++++ ja/installation/system_requirements.mdx | 3 +++ ko/installation/manual_install.mdx | 4 ++++ ko/installation/system_requirements.mdx | 3 +++ zh/installation/manual_install.mdx | 4 ++++ zh/installation/system_requirements.mdx | 4 ++++ 8 files changed, 29 insertions(+) diff --git a/installation/manual_install.mdx b/installation/manual_install.mdx index 96621b0ff..2c1be0fb1 100644 --- a/installation/manual_install.mdx +++ b/installation/manual_install.mdx @@ -19,6 +19,10 @@ For the installation of ComfyUI, it is mainly divided into several steps: You can also refer to [ComfyUI CLI](/comfy-cli/getting-started) to install ComfyUI, it is a command line tool that can easily install ComfyUI and manage its dependencies. + +**Docker:** ComfyUI does not provide an official Docker image. If you want to run ComfyUI in a container, search [Docker Hub](https://hub.docker.com) for community-maintained images — but **none of these are official ComfyUI images**, and they are not supported by the ComfyUI team. Use them at your own risk. + + ## Create a virtual environment diff --git a/installation/system_requirements.mdx b/installation/system_requirements.mdx index 0cbe02491..e6b22e566 100644 --- a/installation/system_requirements.mdx +++ b/installation/system_requirements.mdx @@ -22,6 +22,9 @@ See the links below for installation instructions specific to your OS and setup. + +**Docker:** ComfyUI does not provide an official Docker image. If you want to run ComfyUI in a container, search [Docker Hub](https://hub.docker.com) for community-maintained images — but **none of these are official ComfyUI images**, and they are not supported by the ComfyUI team. Use them at your own risk. + ### Python Version diff --git a/ja/installation/manual_install.mdx b/ja/installation/manual_install.mdx index 4f804e1fd..c9c9c07c4 100644 --- a/ja/installation/manual_install.mdx +++ b/ja/installation/manual_install.mdx @@ -21,6 +21,10 @@ ComfyUI のインストールは、主に以下のいくつかのステップに ComfyUI のインストールには、[ComfyUI CLI](/ja/comfy-cli/getting-started) を参照することもできます。これは、ComfyUI を簡単にインストールし、その依存関係を管理できるコマンドラインツールです。 + +**Docker：** ComfyUI は公式の Docker イメージを提供していません。コンテナで実行したい場合は、[Docker Hub](https://hub.docker.com) でコミュニティがメンテナンスするイメージを自分で検索してください。ただし、**いずれも ComfyUI 公式イメージではなく**、ComfyUI チームによるサポートもありません。自己責任でご利用ください。 + + ## 仮想環境の作成 diff --git a/ja/installation/system_requirements.mdx b/ja/installation/system_requirements.mdx index 89e548115..a7221eb53 100644 --- a/ja/installation/system_requirements.mdx +++ b/ja/installation/system_requirements.mdx @@ -24,6 +24,9 @@ import InstallLink from "/snippets/ja/install/install-link.mdx" + +**Docker：** ComfyUI は公式の Docker イメージを提供していません。コンテナで実行したい場合は、[Docker Hub](https://hub.docker.com) でコミュニティがメンテナンスするイメージを自分で検索してください。ただし、**いずれも ComfyUI 公式イメージではなく**、ComfyUI チームによるサポートもありません。自己責任でご利用ください。 + ### Python バージョン diff --git a/ko/installation/manual_install.mdx b/ko/installation/manual_install.mdx index 8abb7815b..466f602a2 100644 --- a/ko/installation/manual_install.mdx +++ b/ko/installation/manual_install.mdx @@ -21,6 +21,10 @@ ComfyUI를 설치하려면 주로 다음 몇 가지 단계로 나뉩니다: [ComfyUI CLI](/ko/comfy-cli/getting-started)를 참고해 ComfyUI를 설치할 수도 있습니다. 이는 명령줄 도구로, ComfyUI를 쉽게 설치하고 의존성을 관리할 수 있습니다. + +**Docker:** ComfyUI는 공식 Docker 이미지를 제공하지 않습니다. 컨테이너에서 실행하려면 [Docker Hub](https://hub.docker.com)에서 커뮤니티가 유지보수하는 이미지를 직접 검색하세요. 하지만 **이미지는 모두 ComfyUI 공식 이미지가 아니며**, ComfyUI 팀의 공식 지원도 받지 않습니다. 사용에 따른 책임은 사용자에게 있습니다. + + ## 가상 환경 생성하기 diff --git a/ko/installation/system_requirements.mdx b/ko/installation/system_requirements.mdx index 548fbb69d..13d24bb1f 100644 --- a/ko/installation/system_requirements.mdx +++ b/ko/installation/system_requirements.mdx @@ -24,6 +24,9 @@ import InstallLink from "/snippets/ko/install/install-link.mdx" + +**Docker:** ComfyUI는 공식 Docker 이미지를 제공하지 않습니다. 컨테이너에서 실행하려면 [Docker Hub](https://hub.docker.com)에서 커뮤니티가 유지보수하는 이미지를 직접 검색하세요. 하지만 **이미지는 모두 ComfyUI 공식 이미지가 아니며**, ComfyUI 팀의 공식 지원도 받지 않습니다. 사용에 따른 책임은 사용자에게 있습니다. + ### Python 버전 diff --git a/zh/installation/manual_install.mdx b/zh/installation/manual_install.mdx index 770bc94e1..05833f748 100644 --- a/zh/installation/manual_install.mdx +++ b/zh/installation/manual_install.mdx @@ -21,6 +21,10 @@ import AddExternalModels from "/snippets/zh/install/add-external-models.mdx" 你也可以参考 [ComfyUI CLI](/zh/comfy-cli/getting-started) 来安装 ComfyUI, 它是一个命令行工具，可以方便地安装 ComfyUI 并管理其依赖。 + +**Docker：** ComfyUI 不提供官方 Docker 镜像。若需在容器中运行，请自行在 [Docker Hub](https://hub.docker.com) 搜索社区维护的镜像，但**这些均非 ComfyUI 官方镜像**，也不受 ComfyUI 团队支持，请自行评估风险后使用。 + + ## （可选）创建虚拟环境 diff --git a/zh/installation/system_requirements.mdx b/zh/installation/system_requirements.mdx index 1b77ceede..336add5f3 100644 --- a/zh/installation/system_requirements.mdx +++ b/zh/installation/system_requirements.mdx @@ -24,6 +24,10 @@ import InstallLink from "/snippets/zh/install/install-link.mdx" + +**Docker：** ComfyUI 不提供官方 Docker 镜像。若需在容器中运行，请自行在 [Docker Hub](https://hub.docker.com) 搜索社区维护的镜像，但**这些均非 ComfyUI 官方镜像**，也不受 ComfyUI 团队支持，请自行评估风险后使用。 + + ### Python 版本 - **Python 3.13** 支持良好，推荐使用 From ee530afc258ecfc7e61cbd5573110e7f6d3075fc Mon Sep 17 00:00:00 2001 From: ComfyUI Wiki Date: Mon, 6 Jul 2026 09:09:04 +0800 Subject: [PATCH 2/6] docs: extract Docker notice into shared snippets Move the Docker disclaimer into install/docker-notice snippets for EN/ZH/JA/KO and reference them from system requirements and manual install only. --- installation/manual_install.mdx | 6 +++--- installation/system_requirements.mdx | 6 +++--- ja/installation/manual_install.mdx | 6 +++--- ja/installation/system_requirements.mdx | 6 +++--- ko/installation/manual_install.mdx | 6 +++--- ko/installation/system_requirements.mdx | 6 +++--- snippets/install/docker-notice.mdx | 3 +++ snippets/ja/install/docker-notice.mdx | 3 +++ snippets/ko/install/docker-notice.mdx | 3 +++ snippets/zh/install/docker-notice.mdx | 3 +++ zh/installation/manual_install.mdx | 6 +++--- zh/installation/system_requirements.mdx | 6 +++--- 12 files changed, 36 insertions(+), 24 deletions(-) create mode 100644 snippets/install/docker-notice.mdx create mode 100644 snippets/ja/install/docker-notice.mdx create mode 100644 snippets/ko/install/docker-notice.mdx create mode 100644 snippets/zh/install/docker-notice.mdx diff --git a/installation/manual_install.mdx b/installation/manual_install.mdx index 2c1be0fb1..14304c0cf 100644 --- a/installation/manual_install.mdx +++ b/installation/manual_install.mdx @@ -10,6 +10,8 @@ import PipInstall from "/snippets/pip-install.mdx"; import InstallGpuDependencies from "/snippets/install-gpu-dependencies.mdx"; import RunComfy from "/snippets/run-comfy.mdx"; import AddExternalModels from "/snippets/install/add-external-models.mdx" +import DockerNotice from "/snippets/install/docker-notice.mdx" + For the installation of ComfyUI, it is mainly divided into several steps: 1. Create a virtual environment(avoid polluting the system-level Python environment) @@ -19,9 +21,7 @@ For the installation of ComfyUI, it is mainly divided into several steps: You can also refer to [ComfyUI CLI](/comfy-cli/getting-started) to install ComfyUI, it is a command line tool that can easily install ComfyUI and manage its dependencies. - -**Docker:** ComfyUI does not provide an official Docker image. If you want to run ComfyUI in a container, search [Docker Hub](https://hub.docker.com) for community-maintained images — but **none of these are official ComfyUI images**, and they are not supported by the ComfyUI team. Use them at your own risk. - + ## Create a virtual environment diff --git a/installation/system_requirements.mdx b/installation/system_requirements.mdx index e6b22e566..f7c077128 100644 --- a/installation/system_requirements.mdx +++ b/installation/system_requirements.mdx @@ -6,6 +6,8 @@ icon: "computer" --- import InstallLink from "/snippets/install/install-link.mdx" +import DockerNotice from "/snippets/install/docker-notice.mdx" + In this guide, we will introduce the system requirements for installing ComfyUI. Due to frequent updates of ComfyUI, this document may not be updated in a timely manner. Please refer to the relevant instructions in [ComfyUI](https://github.com/Comfy-Org/ComfyUI). @@ -22,9 +24,7 @@ See the links below for installation instructions specific to your OS and setup. - -**Docker:** ComfyUI does not provide an official Docker image. If you want to run ComfyUI in a container, search [Docker Hub](https://hub.docker.com) for community-maintained images — but **none of these are official ComfyUI images**, and they are not supported by the ComfyUI team. Use them at your own risk. - + ### Python Version diff --git a/ja/installation/manual_install.mdx b/ja/installation/manual_install.mdx index c9c9c07c4..98b0345c5 100644 --- a/ja/installation/manual_install.mdx +++ b/ja/installation/manual_install.mdx @@ -12,6 +12,8 @@ import PipInstall from "/snippets/ja/pip-install.mdx"; import InstallGpuDependencies from "/snippets/ja/install-gpu-dependencies.mdx"; import RunComfy from "/snippets/ja/run-comfy.mdx"; import AddExternalModels from "/snippets/ja/install/add-external-models.mdx" +import DockerNotice from "/snippets/ja/install/docker-notice.mdx" + ComfyUI のインストールは、主に以下のいくつかのステップに分かれます： 1. 仮想環境を作成する（システムレベルの Python 環境を汚染しないため） @@ -21,9 +23,7 @@ ComfyUI のインストールは、主に以下のいくつかのステップに ComfyUI のインストールには、[ComfyUI CLI](/ja/comfy-cli/getting-started) を参照することもできます。これは、ComfyUI を簡単にインストールし、その依存関係を管理できるコマンドラインツールです。 - -**Docker：** ComfyUI は公式の Docker イメージを提供していません。コンテナで実行したい場合は、[Docker Hub](https://hub.docker.com) でコミュニティがメンテナンスするイメージを自分で検索してください。ただし、**いずれも ComfyUI 公式イメージではなく**、ComfyUI チームによるサポートもありません。自己責任でご利用ください。 - + ## 仮想環境の作成 diff --git a/ja/installation/system_requirements.mdx b/ja/installation/system_requirements.mdx index a7221eb53..56c8b7c81 100644 --- a/ja/installation/system_requirements.mdx +++ b/ja/installation/system_requirements.mdx @@ -8,6 +8,8 @@ translationFrom: installation/system_requirements.mdx --- import InstallLink from "/snippets/ja/install/install-link.mdx" +import DockerNotice from "/snippets/ja/install/docker-notice.mdx" + このガイドでは、ComfyUI をインストールするためのシステム要件について紹介します。ComfyUI は頻繁に更新されるため、このドキュメントは適時に更新されない場合があります。詳細については、[ComfyUI](https://github.com/Comfy-Org/ComfyUI) の関連説明を参照してください。 @@ -24,9 +26,7 @@ import InstallLink from "/snippets/ja/install/install-link.mdx" - -**Docker：** ComfyUI は公式の Docker イメージを提供していません。コンテナで実行したい場合は、[Docker Hub](https://hub.docker.com) でコミュニティがメンテナンスするイメージを自分で検索してください。ただし、**いずれも ComfyUI 公式イメージではなく**、ComfyUI チームによるサポートもありません。自己責任でご利用ください。 - + ### Python バージョン diff --git a/ko/installation/manual_install.mdx b/ko/installation/manual_install.mdx index 466f602a2..705f19832 100644 --- a/ko/installation/manual_install.mdx +++ b/ko/installation/manual_install.mdx @@ -12,6 +12,8 @@ import PipInstall from "/snippets/ko/pip-install.mdx"; import InstallGpuDependencies from "/snippets/ko/install-gpu-dependencies.mdx"; import RunComfy from "/snippets/ko/run-comfy.mdx"; import AddExternalModels from "/snippets/ko/install/add-external-models.mdx" +import DockerNotice from "/snippets/ko/install/docker-notice.mdx" + ComfyUI를 설치하려면 주로 다음 몇 가지 단계로 나뉩니다: 1. 가상 환경 생성하기(시스템 레벨 파이썬 환경 오염 피하기) @@ -21,9 +23,7 @@ ComfyUI를 설치하려면 주로 다음 몇 가지 단계로 나뉩니다: [ComfyUI CLI](/ko/comfy-cli/getting-started)를 참고해 ComfyUI를 설치할 수도 있습니다. 이는 명령줄 도구로, ComfyUI를 쉽게 설치하고 의존성을 관리할 수 있습니다. - -**Docker:** ComfyUI는 공식 Docker 이미지를 제공하지 않습니다. 컨테이너에서 실행하려면 [Docker Hub](https://hub.docker.com)에서 커뮤니티가 유지보수하는 이미지를 직접 검색하세요. 하지만 **이미지는 모두 ComfyUI 공식 이미지가 아니며**, ComfyUI 팀의 공식 지원도 받지 않습니다. 사용에 따른 책임은 사용자에게 있습니다. - + ## 가상 환경 생성하기 diff --git a/ko/installation/system_requirements.mdx b/ko/installation/system_requirements.mdx index 13d24bb1f..ff8cad2b7 100644 --- a/ko/installation/system_requirements.mdx +++ b/ko/installation/system_requirements.mdx @@ -8,6 +8,8 @@ translationFrom: installation/system_requirements.mdx --- import InstallLink from "/snippets/ko/install/install-link.mdx" +import DockerNotice from "/snippets/ko/install/docker-notice.mdx" + 이 가이드에서는 ComfyUI를 설치하기 위한 시스템 요구사항을 소개합니다. ComfyUI는 수시로 업데이트되기 때문에 이 문서가 최신 상태로 유지되지 않을 수 있습니다. 관련 지침은 [ComfyUI](https://github.com/Comfy-Org/ComfyUI)를 참조해 주세요. @@ -24,9 +26,7 @@ import InstallLink from "/snippets/ko/install/install-link.mdx" - -**Docker:** ComfyUI는 공식 Docker 이미지를 제공하지 않습니다. 컨테이너에서 실행하려면 [Docker Hub](https://hub.docker.com)에서 커뮤니티가 유지보수하는 이미지를 직접 검색하세요. 하지만 **이미지는 모두 ComfyUI 공식 이미지가 아니며**, ComfyUI 팀의 공식 지원도 받지 않습니다. 사용에 따른 책임은 사용자에게 있습니다. - + ### Python 버전 diff --git a/snippets/install/docker-notice.mdx b/snippets/install/docker-notice.mdx new file mode 100644 index 000000000..99d0be730 --- /dev/null +++ b/snippets/install/docker-notice.mdx @@ -0,0 +1,3 @@ + +**Docker:** ComfyUI does not provide an official Docker image. If you want to run ComfyUI in a container, search [Docker Hub](https://hub.docker.com) for community-maintained images — but **none of these are official ComfyUI images**, and they are not supported by the ComfyUI team. Use them at your own risk. + diff --git a/snippets/ja/install/docker-notice.mdx b/snippets/ja/install/docker-notice.mdx new file mode 100644 index 000000000..dadd79895 --- /dev/null +++ b/snippets/ja/install/docker-notice.mdx @@ -0,0 +1,3 @@ + +**Docker：** ComfyUI は公式の Docker イメージを提供していません。コンテナで実行したい場合は、[Docker Hub](https://hub.docker.com) でコミュニティがメンテナンスするイメージを自分で検索してください。ただし、**いずれも ComfyUI 公式イメージではなく**、ComfyUI チームによるサポートもありません。自己責任でご利用ください。 + diff --git a/snippets/ko/install/docker-notice.mdx b/snippets/ko/install/docker-notice.mdx new file mode 100644 index 000000000..ecdafa4f0 --- /dev/null +++ b/snippets/ko/install/docker-notice.mdx @@ -0,0 +1,3 @@ + +**Docker:** ComfyUI는 공식 Docker 이미지를 제공하지 않습니다. 컨테이너에서 실행하려면 [Docker Hub](https://hub.docker.com)에서 커뮤니티가 유지보수하는 이미지를 직접 검색하세요. 하지만 **이미지는 모두 ComfyUI 공식 이미지가 아니며**, ComfyUI 팀의 공식 지원도 받지 않습니다. 사용에 따른 책임은 사용자에게 있습니다. + diff --git a/snippets/zh/install/docker-notice.mdx b/snippets/zh/install/docker-notice.mdx new file mode 100644 index 000000000..dbeaf658a --- /dev/null +++ b/snippets/zh/install/docker-notice.mdx @@ -0,0 +1,3 @@ + +**Docker：** ComfyUI 不提供官方 Docker 镜像。若需在容器中运行，请自行在 [Docker Hub](https://hub.docker.com) 搜索社区维护的镜像，但**这些均非 ComfyUI 官方镜像**，也不受 ComfyUI 团队支持，请自行评估风险后使用。 + diff --git a/zh/installation/manual_install.mdx b/zh/installation/manual_install.mdx index 05833f748..59f8e5565 100644 --- a/zh/installation/manual_install.mdx +++ b/zh/installation/manual_install.mdx @@ -12,6 +12,8 @@ import PipInstall from "/snippets/zh/pip-install.mdx"; import InstallGpuDependencies from "/snippets/zh/install-gpu-dependencies.mdx"; import RunComfy from "/snippets/zh/run-comfy.mdx"; import AddExternalModels from "/snippets/zh/install/add-external-models.mdx" +import DockerNotice from "/snippets/zh/install/docker-notice.mdx" + 对于 ComfyUI 的安装， 主要分为几个步骤 1. 创建一个虚拟环境(避免污染系统级 Python 环境) @@ -21,9 +23,7 @@ import AddExternalModels from "/snippets/zh/install/add-external-models.mdx" 你也可以参考 [ComfyUI CLI](/zh/comfy-cli/getting-started) 来安装 ComfyUI, 它是一个命令行工具，可以方便地安装 ComfyUI 并管理其依赖。 - -**Docker：** ComfyUI 不提供官方 Docker 镜像。若需在容器中运行，请自行在 [Docker Hub](https://hub.docker.com) 搜索社区维护的镜像，但**这些均非 ComfyUI 官方镜像**，也不受 ComfyUI 团队支持，请自行评估风险后使用。 - + ## （可选）创建虚拟环境 diff --git a/zh/installation/system_requirements.mdx b/zh/installation/system_requirements.mdx index 336add5f3..05fdff958 100644 --- a/zh/installation/system_requirements.mdx +++ b/zh/installation/system_requirements.mdx @@ -8,6 +8,8 @@ translationFrom: installation/system_requirements.mdx --- import InstallLink from "/snippets/zh/install/install-link.mdx" +import DockerNotice from "/snippets/zh/install/docker-notice.mdx" + 在本篇我们将介绍安装 ComfyUI 的系统要求，由于 ComfyUI 的更新频繁，本篇文档未必能够及时更新，请参考[ComfyUI](https://github.com/Comfy-Org/ComfyUI)中的相关说明。 @@ -24,9 +26,7 @@ import InstallLink from "/snippets/zh/install/install-link.mdx" - -**Docker：** ComfyUI 不提供官方 Docker 镜像。若需在容器中运行，请自行在 [Docker Hub](https://hub.docker.com) 搜索社区维护的镜像，但**这些均非 ComfyUI 官方镜像**，也不受 ComfyUI 团队支持，请自行评估风险后使用。 - + ### Python 版本 From b2e2090f06b7ac3f461fbdd6bba10a9cbea55711 Mon Sep 17 00:00:00 2001 From: ComfyUI Wiki Date: Mon, 6 Jul 2026 09:32:51 +0800 Subject: [PATCH 3/6] docs: move Docker notice to FAQ section at page end Place under a localized FAQ heading at the bottom of system requirements and manual install pages instead of inline. --- installation/manual_install.mdx | 5 ++++- installation/system_requirements.mdx | 5 ++++- ja/installation/manual_install.mdx | 7 +++++-- ja/installation/system_requirements.mdx | 7 +++++-- ko/installation/manual_install.mdx | 7 +++++-- ko/installation/system_requirements.mdx | 7 +++++-- zh/installation/manual_install.mdx | 7 +++++-- zh/installation/system_requirements.mdx | 7 +++++-- 8 files changed, 38 insertions(+), 14 deletions(-) diff --git a/installation/manual_install.mdx b/installation/manual_install.mdx index 14304c0cf..57c5865db 100644 --- a/installation/manual_install.mdx +++ b/installation/manual_install.mdx @@ -21,7 +21,6 @@ For the installation of ComfyUI, it is mainly divided into several steps: You can also refer to [ComfyUI CLI](/comfy-cli/getting-started) to install ComfyUI, it is a command line tool that can easily install ComfyUI and manage its dependencies. - ## Create a virtual environment @@ -88,3 +87,7 @@ For advanced server configuration (custom port, LAN access, VRAM modes, and more + +## FAQ + + diff --git a/installation/system_requirements.mdx b/installation/system_requirements.mdx index f7c077128..992cdc998 100644 --- a/installation/system_requirements.mdx +++ b/installation/system_requirements.mdx @@ -24,7 +24,6 @@ See the links below for installation instructions specific to your OS and setup. - ### Python Version @@ -64,3 +63,7 @@ The Windows portable build currently comes with Python 3.13 and PyTorch CUDA 13. Please refer to the manual installation section for detailed installation steps. + +## FAQ + + diff --git a/ja/installation/manual_install.mdx b/ja/installation/manual_install.mdx index 98b0345c5..f49c9cc7e 100644 --- a/ja/installation/manual_install.mdx +++ b/ja/installation/manual_install.mdx @@ -23,7 +23,6 @@ ComfyUI のインストールは、主に以下のいくつかのステップに ComfyUI のインストールには、[ComfyUI CLI](/ja/comfy-cli/getting-started) を参照することもできます。これは、ComfyUI を簡単にインストールし、その依存関係を管理できるコマンドラインツールです。 - ## 仮想環境の作成 @@ -89,4 +88,8 @@ git clone https://github.com/Comfy-Org/ComfyUI.git - \ No newline at end of file + + +## よくある質問 + + diff --git a/ja/installation/system_requirements.mdx b/ja/installation/system_requirements.mdx index 56c8b7c81..2200adf02 100644 --- a/ja/installation/system_requirements.mdx +++ b/ja/installation/system_requirements.mdx @@ -26,7 +26,6 @@ import DockerNotice from "/snippets/ja/install/docker-notice.mdx" - ### Python バージョン @@ -65,4 +64,8 @@ Windows ポータブル版には現在、Python 3.13 と PyTorch CUDA 13.0 が 詳細なインストール手順については、手動インストールセクションを参照してください。 - \ No newline at end of file + + +## よくある質問 + + diff --git a/ko/installation/manual_install.mdx b/ko/installation/manual_install.mdx index 705f19832..d78eac718 100644 --- a/ko/installation/manual_install.mdx +++ b/ko/installation/manual_install.mdx @@ -23,7 +23,6 @@ ComfyUI를 설치하려면 주로 다음 몇 가지 단계로 나뉩니다: [ComfyUI CLI](/ko/comfy-cli/getting-started)를 참고해 ComfyUI를 설치할 수도 있습니다. 이는 명령줄 도구로, ComfyUI를 쉽게 설치하고 의존성을 관리할 수 있습니다. - ## 가상 환경 생성하기 @@ -89,4 +88,8 @@ git clone https://github.com/Comfy-Org/ComfyUI.git - \ No newline at end of file + + +## 자주 묻는 질문 + + diff --git a/ko/installation/system_requirements.mdx b/ko/installation/system_requirements.mdx index ff8cad2b7..5d5b1fe8d 100644 --- a/ko/installation/system_requirements.mdx +++ b/ko/installation/system_requirements.mdx @@ -26,7 +26,6 @@ import DockerNotice from "/snippets/ko/install/docker-notice.mdx" - ### Python 버전 @@ -65,4 +64,8 @@ PyTorch 2.4 이상도 지원되지만, 일부 기능과 최적화는 최신 버 자세한 설치 단계는 수동 설치 섹션을 참조해 주세요. - \ No newline at end of file + + +## 자주 묻는 질문 + + diff --git a/zh/installation/manual_install.mdx b/zh/installation/manual_install.mdx index 59f8e5565..98fd5e985 100644 --- a/zh/installation/manual_install.mdx +++ b/zh/installation/manual_install.mdx @@ -23,7 +23,6 @@ import DockerNotice from "/snippets/zh/install/docker-notice.mdx" 你也可以参考 [ComfyUI CLI](/zh/comfy-cli/getting-started) 来安装 ComfyUI, 它是一个命令行工具，可以方便地安装 ComfyUI 并管理其依赖。 - ## （可选）创建虚拟环境 @@ -89,4 +88,8 @@ git clone https://github.com/Comfy-Org/ComfyUI.git - \ No newline at end of file + + +## 常见问题 + + diff --git a/zh/installation/system_requirements.mdx b/zh/installation/system_requirements.mdx index 05fdff958..0669cc67d 100644 --- a/zh/installation/system_requirements.mdx +++ b/zh/installation/system_requirements.mdx @@ -26,7 +26,6 @@ import DockerNotice from "/snippets/zh/install/docker-notice.mdx" - ### Python 版本 @@ -65,4 +64,8 @@ Windows 便携版目前附带 Python 3.13 和 PyTorch CUDA 13.0。如果无法 请参考手动安装章节了解详细的安装步骤。 - \ No newline at end of file + + +## 常见问题 + + From fc9877cb31bc107b113e9ab622e43008fc1f1f4a Mon Sep 17 00:00:00 2001 From: ComfyUI Wiki Date: Mon, 6 Jul 2026 09:34:06 +0800 Subject: [PATCH 4/6] chore(i18n): sync translation hashes for Docker notice updates Refresh translationSourceHash on zh/ja/ko pages and snippet hash comments after system requirements and manual install changes. --- ja/installation/manual_install.mdx | 2 +- ja/installation/system_requirements.mdx | 2 +- ko/installation/manual_install.mdx | 2 +- ko/installation/system_requirements.mdx | 2 +- snippets/ja/install/docker-notice.mdx | 1 + snippets/ko/install/docker-notice.mdx | 1 + snippets/zh/install/docker-notice.mdx | 1 + zh/installation/manual_install.mdx | 2 +- zh/installation/system_requirements.mdx | 2 +- 9 files changed, 9 insertions(+), 6 deletions(-) diff --git a/ja/installation/manual_install.mdx b/ja/installation/manual_install.mdx index f49c9cc7e..6ba8d4bd4 100644 --- a/ja/installation/manual_install.mdx +++ b/ja/installation/manual_install.mdx @@ -3,7 +3,7 @@ title: "異なるシステムで ComfyUI を手動インストールする方法 Description: "このセクションでは、Windows、MacOS、Linux での手動インストールプロセスをガイドします" icon: "wrench" sidebarTitle: "手動インストール" -translationSourceHash: 1bcf6d3f +translationSourceHash: fb64f526 translationFrom: installation/manual_install.mdx --- diff --git a/ja/installation/system_requirements.mdx b/ja/installation/system_requirements.mdx index 2200adf02..576c1f0c9 100644 --- a/ja/installation/system_requirements.mdx +++ b/ja/installation/system_requirements.mdx @@ -3,7 +3,7 @@ title: "システム要件" description: "ComfyUIをインストールして実行するためのハードウェアとソフトウェアの要件" sidebarTitle: "システム要件" icon: "computer" -translationSourceHash: cc08dd2f +translationSourceHash: db65e98b translationFrom: installation/system_requirements.mdx --- diff --git a/ko/installation/manual_install.mdx b/ko/installation/manual_install.mdx index d78eac718..c883563d3 100644 --- a/ko/installation/manual_install.mdx +++ b/ko/installation/manual_install.mdx @@ -3,7 +3,7 @@ title: "수동 설치 — 로컬 자체 호스팅" description: "이 섹션에서는 Windows, MacOS 및 Linux에서의 수동 설치 과정을 안내합니다." icon: "wrench" sidebarTitle: "수동(로컬)" -translationSourceHash: 1bcf6d3f +translationSourceHash: fb64f526 translationFrom: installation/manual_install.mdx --- diff --git a/ko/installation/system_requirements.mdx b/ko/installation/system_requirements.mdx index 5d5b1fe8d..042265b18 100644 --- a/ko/installation/system_requirements.mdx +++ b/ko/installation/system_requirements.mdx @@ -3,7 +3,7 @@ title: "시스템 요구사항" description: "ComfyUI 설치 및 실행을 위한 하드웨어 및 소프트웨어 요구 사항." sidebarTitle: "시스템 요구사항" icon: "computer" -translationSourceHash: cc08dd2f +translationSourceHash: db65e98b translationFrom: installation/system_requirements.mdx --- diff --git a/snippets/ja/install/docker-notice.mdx b/snippets/ja/install/docker-notice.mdx index dadd79895..e888b9131 100644 --- a/snippets/ja/install/docker-notice.mdx +++ b/snippets/ja/install/docker-notice.mdx @@ -1,3 +1,4 @@ +{/* translationSourceHash: 6f3ab8ed */} **Docker：** ComfyUI は公式の Docker イメージを提供していません。コンテナで実行したい場合は、[Docker Hub](https://hub.docker.com) でコミュニティがメンテナンスするイメージを自分で検索してください。ただし、**いずれも ComfyUI 公式イメージではなく**、ComfyUI チームによるサポートもありません。自己責任でご利用ください。 diff --git a/snippets/ko/install/docker-notice.mdx b/snippets/ko/install/docker-notice.mdx index ecdafa4f0..dbee0b028 100644 --- a/snippets/ko/install/docker-notice.mdx +++ b/snippets/ko/install/docker-notice.mdx @@ -1,3 +1,4 @@ +{/* translationSourceHash: 6f3ab8ed */} **Docker:** ComfyUI는 공식 Docker 이미지를 제공하지 않습니다. 컨테이너에서 실행하려면 [Docker Hub](https://hub.docker.com)에서 커뮤니티가 유지보수하는 이미지를 직접 검색하세요. 하지만 **이미지는 모두 ComfyUI 공식 이미지가 아니며**, ComfyUI 팀의 공식 지원도 받지 않습니다. 사용에 따른 책임은 사용자에게 있습니다. diff --git a/snippets/zh/install/docker-notice.mdx b/snippets/zh/install/docker-notice.mdx index dbeaf658a..971da080c 100644 --- a/snippets/zh/install/docker-notice.mdx +++ b/snippets/zh/install/docker-notice.mdx @@ -1,3 +1,4 @@ +{/* translationSourceHash: 6f3ab8ed */} **Docker：** ComfyUI 不提供官方 Docker 镜像。若需在容器中运行，请自行在 [Docker Hub](https://hub.docker.com) 搜索社区维护的镜像，但**这些均非 ComfyUI 官方镜像**，也不受 ComfyUI 团队支持，请自行评估风险后使用。 diff --git a/zh/installation/manual_install.mdx b/zh/installation/manual_install.mdx index 98fd5e985..7fbcd893b 100644 --- a/zh/installation/manual_install.mdx +++ b/zh/installation/manual_install.mdx @@ -3,7 +3,7 @@ title: "如何在不同系统上手动安装 ComfyUI" description: "本部分将指导你完成在 Windows、MacOS 以及 Linux 的手动安装过程" icon: "wrench" sidebarTitle: "手动安装" -translationSourceHash: 1bcf6d3f +translationSourceHash: fb64f526 translationFrom: installation/manual_install.mdx --- diff --git a/zh/installation/system_requirements.mdx b/zh/installation/system_requirements.mdx index 0669cc67d..06c293b39 100644 --- a/zh/installation/system_requirements.mdx +++ b/zh/installation/system_requirements.mdx @@ -3,7 +3,7 @@ title: "系统要求" description: "安装和运行 ComfyUI 的硬件和软件要求" sidebarTitle: "系统要求" icon: "computer" -translationSourceHash: cc08dd2f +translationSourceHash: db65e98b translationFrom: installation/system_requirements.mdx --- From 7b074c03c26b58b62e38e93007300311a1617802 Mon Sep 17 00:00:00 2001 From: ComfyUI Wiki Date: Mon, 6 Jul 2026 09:39:43 +0800 Subject: [PATCH 5/6] fix: escape <= in OpenAIGPTImageNodeV2 MDX to fix mint-checks Unescaped <= was parsed as JSX and broke mint broken-links validation. --- built-in-nodes/OpenAIGPTImageNodeV2.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/built-in-nodes/OpenAIGPTImageNodeV2.mdx b/built-in-nodes/OpenAIGPTImageNodeV2.mdx index d7912d7d7..e275b4aae 100644 --- a/built-in-nodes/OpenAIGPTImageNodeV2.mdx +++ b/built-in-nodes/OpenAIGPTImageNodeV2.mdx @@ -28,7 +28,7 @@ This node generates images using OpenAI's GPT Image API. It supports multiple mo **Parameter Constraints and Limitations:** -- When using `gpt-image-2` with a `model.size` of "Custom", the `custom_width` and `custom_height` must be multiples of 16, the maximum edge must be <= 3840, the aspect ratio must not exceed 3:1, and the total pixel count must be between 655,360 and 8,294,400. +- When using `gpt-image-2` with a `model.size` of "Custom", the `custom_width` and `custom_height` must be multiples of 16, the maximum edge must be `<= 3840`, the aspect ratio must not exceed 3:1, and the total pixel count must be between 655,360 and 8,294,400. - If a `mask` is provided, an input image (`model.images`) is required. A mask cannot be used without an input image. - A mask cannot be used with multiple input images. - When a mask is provided, the mask dimensions must match the input image dimensions. From dfa339865926b8d32bcaec6990370590026a72fb Mon Sep 17 00:00:00 2001 From: ComfyUI Wiki Date: Mon, 6 Jul 2026 09:42:42 +0800 Subject: [PATCH 6/6] docs: remove em dash from Docker notice per review Split the English Docker notice into separate sentences to match the English MDX style guide. Refresh snippet translation hashes. --- snippets/install/docker-notice.mdx | 2 +- snippets/ja/install/docker-notice.mdx | 2 +- snippets/ko/install/docker-notice.mdx | 2 +- snippets/zh/install/docker-notice.mdx | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/snippets/install/docker-notice.mdx b/snippets/install/docker-notice.mdx index 99d0be730..27ac1f28e 100644 --- a/snippets/install/docker-notice.mdx +++ b/snippets/install/docker-notice.mdx @@ -1,3 +1,3 @@ -**Docker:** ComfyUI does not provide an official Docker image. If you want to run ComfyUI in a container, search [Docker Hub](https://hub.docker.com) for community-maintained images — but **none of these are official ComfyUI images**, and they are not supported by the ComfyUI team. Use them at your own risk. +**Docker:** ComfyUI does not provide an official Docker image. If you want to run ComfyUI in a container, search [Docker Hub](https://hub.docker.com) for community-maintained images. Note that **none of these are official ComfyUI images**, and they are not supported by the ComfyUI team. Use them at your own risk. diff --git a/snippets/ja/install/docker-notice.mdx b/snippets/ja/install/docker-notice.mdx index e888b9131..c25b991dd 100644 --- a/snippets/ja/install/docker-notice.mdx +++ b/snippets/ja/install/docker-notice.mdx @@ -1,4 +1,4 @@ -{/* translationSourceHash: 6f3ab8ed */} +{/* translationSourceHash: 6e98606f */} **Docker：** ComfyUI は公式の Docker イメージを提供していません。コンテナで実行したい場合は、[Docker Hub](https://hub.docker.com) でコミュニティがメンテナンスするイメージを自分で検索してください。ただし、**いずれも ComfyUI 公式イメージではなく**、ComfyUI チームによるサポートもありません。自己責任でご利用ください。 diff --git a/snippets/ko/install/docker-notice.mdx b/snippets/ko/install/docker-notice.mdx index dbee0b028..7e008a4b9 100644 --- a/snippets/ko/install/docker-notice.mdx +++ b/snippets/ko/install/docker-notice.mdx @@ -1,4 +1,4 @@ -{/* translationSourceHash: 6f3ab8ed */} +{/* translationSourceHash: 6e98606f */} **Docker:** ComfyUI는 공식 Docker 이미지를 제공하지 않습니다. 컨테이너에서 실행하려면 [Docker Hub](https://hub.docker.com)에서 커뮤니티가 유지보수하는 이미지를 직접 검색하세요. 하지만 **이미지는 모두 ComfyUI 공식 이미지가 아니며**, ComfyUI 팀의 공식 지원도 받지 않습니다. 사용에 따른 책임은 사용자에게 있습니다. diff --git a/snippets/zh/install/docker-notice.mdx b/snippets/zh/install/docker-notice.mdx index 971da080c..daff20412 100644 --- a/snippets/zh/install/docker-notice.mdx +++ b/snippets/zh/install/docker-notice.mdx @@ -1,4 +1,4 @@ -{/* translationSourceHash: 6f3ab8ed */} +{/* translationSourceHash: 6e98606f */} **Docker：** ComfyUI 不提供官方 Docker 镜像。若需在容器中运行，请自行在 [Docker Hub](https://hub.docker.com) 搜索社区维护的镜像，但**这些均非 ComfyUI 官方镜像**，也不受 ComfyUI 团队支持，请自行评估风险后使用。