From f3fa67dc0db11074d6a9a2d69525d6b91f65ea7f Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Tue, 21 Jul 2026 06:10:47 +0800 Subject: [PATCH 1/3] docs: add MLX FAQ entry to system requirements page Two users asked about MLX support in ComfyUI on 2026-07-18 via the Mintlify AI assistant. The docs did not address whether ComfyUI uses MLX or how acceleration works on Apple Silicon. Adds an Accordion FAQ entry to the system requirements page clarifying that ComfyUI uses PyTorch MPS backend (not MLX) on Apple Silicon Macs, with a command to verify MPS availability. Source: Mintlify AI Assistant analytics data (2026-07-18) --- installation/system_requirements.mdx | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/installation/system_requirements.mdx b/installation/system_requirements.mdx index 992cdc998..5b127ff43 100644 --- a/installation/system_requirements.mdx +++ b/installation/system_requirements.mdx @@ -66,4 +66,15 @@ Please refer to the manual installation section for detailed installation steps. ## FAQ + +ComfyUI does not use MLX directly. On Apple Silicon (M1/M2/M3/M4) Macs, ComfyUI uses PyTorch with the **MPS (Metal Performance Shaders)** backend, which leverages Apple's Metal graphics framework for GPU acceleration. + +MLX is a separate machine learning framework developed by Apple for research purposes. ComfyUI's PyTorch-based architecture uses MPS instead. + +To verify MPS is working on your Mac: +```bash +python -c "import torch; print(torch.backends.mps.is_available())" +``` + + From c3ef3131be4178a2b0591fb24e760993004a7c4d Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Tue, 21 Jul 2026 15:18:05 +0800 Subject: [PATCH 2/3] docs: add MLX FAQ translations for ja/zh/ko --- ja/installation/system_requirements.mdx | 13 ++++++++++++- ko/installation/system_requirements.mdx | 13 ++++++++++++- zh/installation/system_requirements.mdx | 13 ++++++++++++- 3 files changed, 36 insertions(+), 3 deletions(-) diff --git a/ja/installation/system_requirements.mdx b/ja/installation/system_requirements.mdx index 576c1f0c9..df3e5b99f 100644 --- a/ja/installation/system_requirements.mdx +++ b/ja/installation/system_requirements.mdx @@ -3,7 +3,7 @@ title: "システム要件" description: "ComfyUIをインストールして実行するためのハードウェアとソフトウェアの要件" sidebarTitle: "システム要件" icon: "computer" -translationSourceHash: db65e98b +translationSourceHash: 36efd426 translationFrom: installation/system_requirements.mdx --- @@ -68,4 +68,15 @@ Windows ポータブル版には現在、Python 3.13 と PyTorch CUDA 13.0 が ## よくある質問 + +ComfyUIはMLXを直接使用しません。Apple Silicon（M1/M2/M3/M4）Macでは、PyTorchの **MPS（Metal Performance Shaders）** バックエンドを使用して、AppleのMetalグラフィックスフレームワークによるGPUアクセラレーションを活用します。 + +MLXはAppleが研究目的で開発した独立した機械学習フレームワークです。ComfyUIのPyTorchベースのアーキテクチャでは、代わりにMPSを使用しています。 + +お使いのMacでMPSが動作していることを確認するには： +```bash +python -c "import torch; print(torch.backends.mps.is_available())" +``` + + diff --git a/ko/installation/system_requirements.mdx b/ko/installation/system_requirements.mdx index 042265b18..dda33cd72 100644 --- a/ko/installation/system_requirements.mdx +++ b/ko/installation/system_requirements.mdx @@ -3,7 +3,7 @@ title: "시스템 요구사항" description: "ComfyUI 설치 및 실행을 위한 하드웨어 및 소프트웨어 요구 사항." sidebarTitle: "시스템 요구사항" icon: "computer" -translationSourceHash: db65e98b +translationSourceHash: 36efd426 translationFrom: installation/system_requirements.mdx --- @@ -68,4 +68,15 @@ PyTorch 2.4 이상도 지원되지만, 일부 기능과 최적화는 최신 버 ## 자주 묻는 질문 + +ComfyUI는 MLX를 직접 사용하지 않습니다. Apple Silicon(M1/M2/M3/M4) Mac에서 ComfyUI는 PyTorch의 **MPS(Metal Performance Shaders)** 백엔드를 사용하여 Apple의 Metal 그래픽스 프레임워크로 GPU 가속을 활용합니다. + +MLX는 Apple이 연구 목적으로 개발한 별도의 머신러닝 프레임워크입니다. ComfyUI의 PyTorch 기반 아키텍처는 MPS를 대신 사용합니다. + +Mac에서 MPS가 정상 작동하는지 확인하려면: +```bash +python -c "import torch; print(torch.backends.mps.is_available())" +``` + + diff --git a/zh/installation/system_requirements.mdx b/zh/installation/system_requirements.mdx index 06c293b39..5d9db20f5 100644 --- a/zh/installation/system_requirements.mdx +++ b/zh/installation/system_requirements.mdx @@ -3,7 +3,7 @@ title: "系统要求" description: "安装和运行 ComfyUI 的硬件和软件要求" sidebarTitle: "系统要求" icon: "computer" -translationSourceHash: db65e98b +translationSourceHash: 36efd426 translationFrom: installation/system_requirements.mdx --- @@ -68,4 +68,15 @@ Windows 便携版目前附带 Python 3.13 和 PyTorch CUDA 13.0。如果无法 ## 常见问题 + +ComfyUI 不直接使用 MLX。在 Apple Silicon（M1/M2/M3/M4）Mac 上，ComfyUI 使用 PyTorch 的 **MPS（Metal Performance Shaders）** 后端，利用 Apple 的 Metal 图形框架进行 GPU 加速。 + +MLX 是 Apple 开发的一个独立的机器学习研究框架。ComfyUI 基于 PyTorch 架构，所以使用 MPS 而非 MLX。 + +要验证 MPS 是否在你的 Mac 上正常工作： +```bash +python -c "import torch; print(torch.backends.mps.is_available())" +``` + + From ff841794983c62a921d0c4b4baeb47dbb076c4f7 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Tue, 21 Jul 2026 15:22:46 +0800 Subject: [PATCH 3/3] docs: correct MLX description - remove 'research purposes', identify as array framework for Apple Silicon --- installation/system_requirements.mdx | 2 +- ja/installation/system_requirements.mdx | 4 ++-- ko/installation/system_requirements.mdx | 4 ++-- zh/installation/system_requirements.mdx | 4 ++-- 4 files changed, 7 insertions(+), 7 deletions(-) diff --git a/installation/system_requirements.mdx b/installation/system_requirements.mdx index 5b127ff43..21b6cb4f7 100644 --- a/installation/system_requirements.mdx +++ b/installation/system_requirements.mdx @@ -69,7 +69,7 @@ Please refer to the manual installation section for detailed installation steps. ComfyUI does not use MLX directly. On Apple Silicon (M1/M2/M3/M4) Macs, ComfyUI uses PyTorch with the **MPS (Metal Performance Shaders)** backend, which leverages Apple's Metal graphics framework for GPU acceleration. -MLX is a separate machine learning framework developed by Apple for research purposes. ComfyUI's PyTorch-based architecture uses MPS instead. +MLX is a separate machine-learning array framework designed for Apple Silicon. ComfyUI's PyTorch-based architecture uses MPS instead. To verify MPS is working on your Mac: ```bash diff --git a/ja/installation/system_requirements.mdx b/ja/installation/system_requirements.mdx index df3e5b99f..22be29b62 100644 --- a/ja/installation/system_requirements.mdx +++ b/ja/installation/system_requirements.mdx @@ -3,7 +3,7 @@ title: "システム要件" description: "ComfyUIをインストールして実行するためのハードウェアとソフトウェアの要件" sidebarTitle: "システム要件" icon: "computer" -translationSourceHash: 36efd426 +translationSourceHash: 9a71d8f9 translationFrom: installation/system_requirements.mdx --- @@ -71,7 +71,7 @@ Windows ポータブル版には現在、Python 3.13 と PyTorch CUDA 13.0 が ComfyUIはMLXを直接使用しません。Apple Silicon（M1/M2/M3/M4）Macでは、PyTorchの **MPS（Metal Performance Shaders）** バックエンドを使用して、AppleのMetalグラフィックスフレームワークによるGPUアクセラレーションを活用します。 -MLXはAppleが研究目的で開発した独立した機械学習フレームワークです。ComfyUIのPyTorchベースのアーキテクチャでは、代わりにMPSを使用しています。 +MLXはApple Silicon向けに設計された独立した機械学習配列フレームワークです。ComfyUIのPyTorchベースのアーキテクチャでは、代わりにMPSを使用しています。 お使いのMacでMPSが動作していることを確認するには： ```bash diff --git a/ko/installation/system_requirements.mdx b/ko/installation/system_requirements.mdx index dda33cd72..f6ed2ac6c 100644 --- a/ko/installation/system_requirements.mdx +++ b/ko/installation/system_requirements.mdx @@ -3,7 +3,7 @@ title: "시스템 요구사항" description: "ComfyUI 설치 및 실행을 위한 하드웨어 및 소프트웨어 요구 사항." sidebarTitle: "시스템 요구사항" icon: "computer" -translationSourceHash: 36efd426 +translationSourceHash: 9a71d8f9 translationFrom: installation/system_requirements.mdx --- @@ -71,7 +71,7 @@ PyTorch 2.4 이상도 지원되지만, 일부 기능과 최적화는 최신 버 ComfyUI는 MLX를 직접 사용하지 않습니다. Apple Silicon(M1/M2/M3/M4) Mac에서 ComfyUI는 PyTorch의 **MPS(Metal Performance Shaders)** 백엔드를 사용하여 Apple의 Metal 그래픽스 프레임워크로 GPU 가속을 활용합니다. -MLX는 Apple이 연구 목적으로 개발한 별도의 머신러닝 프레임워크입니다. ComfyUI의 PyTorch 기반 아키텍처는 MPS를 대신 사용합니다. +MLX는 Apple Silicon을 위해 설계된 별도의 머신러닝 배열 프레임워크입니다. ComfyUI의 PyTorch 기반 아키텍처는 MPS를 대신 사용합니다. Mac에서 MPS가 정상 작동하는지 확인하려면: ```bash diff --git a/zh/installation/system_requirements.mdx b/zh/installation/system_requirements.mdx index 5d9db20f5..334d1b632 100644 --- a/zh/installation/system_requirements.mdx +++ b/zh/installation/system_requirements.mdx @@ -3,7 +3,7 @@ title: "系统要求" description: "安装和运行 ComfyUI 的硬件和软件要求" sidebarTitle: "系统要求" icon: "computer" -translationSourceHash: 36efd426 +translationSourceHash: 9a71d8f9 translationFrom: installation/system_requirements.mdx --- @@ -71,7 +71,7 @@ Windows 便携版目前附带 Python 3.13 和 PyTorch CUDA 13.0。如果无法 ComfyUI 不直接使用 MLX。在 Apple Silicon（M1/M2/M3/M4）Mac 上，ComfyUI 使用 PyTorch 的 **MPS（Metal Performance Shaders）** 后端，利用 Apple 的 Metal 图形框架进行 GPU 加速。 -MLX 是 Apple 开发的一个独立的机器学习研究框架。ComfyUI 基于 PyTorch 架构，所以使用 MPS 而非 MLX。 +MLX 是 Apple 为 Apple Silicon 设计的一个独立的机器学习数组框架。ComfyUI 基于 PyTorch 架构，所以使用 MPS 而非 MLX。 要验证 MPS 是否在你的 Mac 上正常工作： ```bash