troubleshooting/overview

[giscus[bot]]

troubleshooting/overview

ComfyUI troubleshooting guide: rule out custom nodes first, fix common core issues, and file a bug report with the right details.

https://docs.comfy.org/troubleshooting/overview

[Aldunnn]

This page suggests that python is required on apple silicon. However it is not listed as a pre-req. in the installation guide.

[lin-bot23]

Hi @Aldunnn, thanks for flagging this. You are reading both pages correctly, and each one is describing a different install path.

Comfy Desktop on macOS manages its own Python environment per instance, so you do not need to install Python to run it. That is why the macOS Desktop install guide lists only OS, hardware, and disk space under requirements.

A manual or source install (clone the repo, then run python main.py) is the path the Apple silicon section of this troubleshooting page describes. On that path ComfyUI runs in a Python environment you provide, so Python is a prerequisite. The supported versions are on the System Requirements page (Python 3.13 recommended, 3.12 as a fallback), and the setup steps are in the Manual Installation guide, which starts by creating a virtual environment and installs Python through Miniconda if you do not have it yet.

The real gap is that the section never said which install path it applies to, so the python main.py commands read as a requirement for every Apple silicon user. I have fixed that in PR #1822, which adds a note scoping the section to manual or source installs and pointing Desktop users to the macOS Desktop guide: #1822

If you are on Desktop and something is actually failing there, post the error message and your ComfyUI version and I will take a look.