ComfyUI 安装教程：macOS 和 Linux 统一步骤

本教程将详细介绍如何在 macOS 和 Linux 上安装 ComfyUI。我们将从安装 Anaconda 开始，到安装 PyTorch 和 ComfyUI，最后提供一些常见问题的解决方法。

macOS和linux安装步骤很相似

可以按照1️⃣安装anaconda2️⃣安装python3️⃣torch4️⃣comfyui

ComfyUI 安装教程：macOS 和 Linux 统一步骤

[1. 安装 Anaconda](#1. 安装 Anaconda)
- [1.1 下载并安装 Anaconda](#1.1 下载并安装 Anaconda)
[2. 创建 Python 虚拟环境](#2. 创建 Python 虚拟环境)
- [2.1 创建并激活虚拟环境](#2.1 创建并激活虚拟环境)
- [2.2 安装xcode（仅macOS）](#2.2 安装xcode（仅macOS）)
[3. 安装 PyTorch](#3. 安装 PyTorch)
- [3.1 安装 PyTorch（macOS无 GPU 支持）](#3.1 安装 PyTorch（macOS无 GPU 支持）)
- [3.2 安装PyTorch（Linux有GPU支持）](#3.2 安装PyTorch（Linux有GPU支持）)
[4. 配置 PIP 缓存目录](#4. 配置 PIP 缓存目录)
- [4.1 配置 PIP 缓存目录](#4.1 配置 PIP 缓存目录)
[5. 安装 ComfyUI](#5. 安装 ComfyUI)
- [5.1 克隆并安装 ComfyUI](#5.1 克隆并安装 ComfyUI)
- [5.2 安装插件管理器](#5.2 安装插件管理器)
- [5.3 安装汉化插件（可选）](#5.3 安装汉化插件（可选）)
- [5.4 启动 ComfyUI](#5.4 启动 ComfyUI)
[6. 常见问题及解决方法](#6. 常见问题及解决方法)
- [6.1 报错：`command not found: conda`](#6.1 报错：command not found: conda)
- [6.2 报错：`Could not find a version that satisfies the requirement`](#6.2 报错：Could not find a version that satisfies the requirement)
- [6.3 报错：`No space left on device`](#6.3 报错：No space left on device)

1. 安装 Anaconda

1.1 下载并安装 Anaconda

下载 Anaconda：
- 访问 Anaconda 官网。
- 选择适合你操作系统的 Anaconda 安装包（macOS 或 Linux）。
安装 Anaconda ：

打开终端并运行以下命令（假设你下载的是 Anaconda3-2023.x.x-MacOSX-x86_64.sh 或 Anaconda3-2023.x.x-Linux-x86_64.sh）：
bash 复制代码
```
bash Anaconda3-2023.x.x-MacOSX-x86_64.sh  # 对于macOS
bash Anaconda3-2023.x.x-Linux-x86_64.sh  # 对于Linux
```
按提示安装：
- 接受许可证（按 Enter 键确认）。
- 选择安装路径（默认情况下为：/Users/your-username/anaconda3 或 /home/your-username/anaconda3）。
- 如果你不想修改安装路径，直接按 Enter 键。
设置 Anaconda 环境变量：
- 在 macOS 上，编辑。~/.zshrc 文件（如果使用 bash ，则是。~/.bash_profile）。
- 在 Linux 上，编辑。~/.bashrc 文件
打开文件进行编辑：
bash 复制代码
```
nano ~/.zshrc  # macOS 使用 zsh
nano ~/.bashrc  # Linux 使用 bash
```
在文件末尾添加以下内容：
bash 复制代码
```
export PATH="$HOME/anaconda3/bin:$PATH"
```
保存并退出编辑器后，运行以下命令使修改生效：
bash 复制代码
```
source ~/.zshrc  # macOS
source ~/.bashrc  # Linux
```
验证安装：在终端中运行：
bash 复制代码
```
conda --version
```

如果安装成功，应该显示 Anaconda 的版本号。

2. 创建 Python 虚拟环境

2.1 创建并激活虚拟环境

使用 conda 创建一个新的 Python 3.12 虚拟环境：
bash 复制代码
```
conda create --name comfyui python=3.12
```
激活虚拟环境：
bash 复制代码
```
conda activate comfyui
```
验证 Python 版本：
bash 复制代码
```
python --version
```
输出应该是 Python 3.12.x。

2.2 安装xcode（仅macOS）

打开终端，输入代码：

bash 复制代码

xcode-select --install

如果报错，也可以直接到app商店，下载xcode，安装即可

3. 安装 PyTorch

3.1 安装 PyTorch（macOS无 GPU 支持）

由于没有 GPU 支持，我们安装 PyTorch CPU 版本。运行以下命令：

安装 PyTorch 、TorchVision 和 Torchaudio：
bash 复制代码
```
conda install pytorch torchvision torchaudio -c pytorch
```
若要安装 PyTorch Nightly 版本，可运行：
bash 复制代码
```
conda install pytorch torchvision torchaudio -c pytorch-nightly
```
这会自动选择适合 CPU 的版本。

3.2 安装PyTorch（Linux有GPU支持）

安装 PyTorch 、TorchVision 和 Torchaudio：

bash 复制代码

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu112 -i https://pypi.tuna.tsinghua.edu.cn/simple

注意自己的CUDA版本，安装对应的版本

4. 配置 PIP 缓存目录

为了避免缓存文件占满磁盘空间，我们可以设置 PIP 缓存目录。

4.1 配置 PIP 缓存目录

设置 PIP 缓存目录：

bash 复制代码

export PIP_CACHE_DIR="/data/osadm/cache"

要使其在每次打开终端时生效，请编辑 ~/.zshrc 或 ~/.bashrc 文件，添加：
bash 复制代码
```
export PIP_CACHE_DIR="/data/osadm/cache"
```

保存文件并使修改生效：

bash 复制代码

source ~/.zshrc  # macOS
source ~/.bashrc  # Linux

5. 安装 ComfyUI

5.1 克隆并安装 ComfyUI

克隆 ComfyUI 仓库：

bash 复制代码

cd ~/
git clone https://github.com/comfyanonymous/ComfyUI
cd ComfyUI

安装 ComfyUI 依赖：
bash 复制代码
```
pip install -r requirements.txt
```

5.2 安装插件管理器

进入 custom_nodes 目录并克隆插件管理器：

bash 复制代码

cd ~/ComfyUI/custom_nodes
git clone https://github.com/ltdrdata/ComfyUI-Manager.git
cd ComfyUI-Manager
pip install -r requirements.txt

5.3 安装汉化插件（可选）

如果需要汉化界面：

bash 复制代码

cd ..
git clone https://github.com/AIGODLIKE/AIGODLIKE-COMFYUI-TRANSLATION.git

5.4 启动 ComfyUI

启动 ComfyUI：
bash 复制代码
```
cd ~/ComfyUI
python main.py
```

6. 常见问题及解决方法

6.1 报错：`command not found: conda`

问题描述：

在安装 Anaconda 后，使用 conda 命令时显示 command not found 错误。

解决方法：

确保 conda 的路径已经正确添加到环境变量中。请按照以下步骤操作：

编辑 ~/.bashrc或 ~/.zshrc 文件，确保添加以下行：
bash 复制代码
```
export PATH="$HOME/anaconda3/bin:$PATH"
```
然后运行以下命令，使修改生效：
bash 复制代码
```
source ~/.bashrc  # Linux
source ~/.zshrc   # macOS
```
如果问题仍然存在，请确保你的 Anaconda 安装路径正确，并检查是否安装了多个版本的 Python。

6.2 报错：`Could not find a version that satisfies the requirement`

问题描述：

在安装依赖时遇到以下错误：

lua 复制代码

Could not find a version that satisfies the requirement <package-name>

解决方法：

这个错误通常是因为 PyPI 上没有找到对应版本的包。你可以尝试以下几种方式解决：

更新 pip：
bash 复制代码
```
pip install --upgrade pip
```

使用清华镜像源安装：

bash 复制代码

pip install <package-name> -i https://pypi.tuna.tsinghua.edu.cn/simple

如果是 PyTorch 相关问题，确保使用与 Python 版本匹配的 PyTorch 安装命令。例如，使用 conda 安装，而不是 pip。

6.3 报错：`No space left on device`

问题描述：

在运行某些安装命令时，遇到以下错误：

lua 复制代码

OSError: [Errno 28] No space left on device

解决方法：

检查磁盘空间：
bash 复制代码
```
df -h
```
清理无用的缓存或临时文件。你可以使用以下命令清理 PIP 缓存：
bash 复制代码
```
pip cache purge
```
如果你的系统磁盘空间不足，可以将安装路径或者缓存目录更改为其他磁盘（例如，/data/osadm/cache）。

ComfyUI 安装教程：macOS 和 Linux 统一步骤

ComfyUI 安装教程：macOS 和 Linux 统一步骤

1. 安装 Anaconda

1.1 下载并安装 Anaconda

2. 创建 Python 虚拟环境

2.1 创建并激活虚拟环境

2.2 安装xcode（仅macOS）

3. 安装 PyTorch

3.1 安装 PyTorch（macOS无 GPU 支持）

3.2 安装PyTorch（Linux有GPU支持）

4. 配置 PIP 缓存目录

4.1 配置 PIP 缓存目录

5. 安装 ComfyUI

5.1 克隆并安装 ComfyUI

5.2 安装插件管理器

5.3 安装汉化插件（可选）

5.4 启动 ComfyUI

6. 常见问题及解决方法

6.1 报错：command not found: conda

6.2 报错：Could not find a version that satisfies the requirement

6.3 报错：No space left on device

6.1 报错：`command not found: conda`

6.2 报错：`Could not find a version that satisfies the requirement`

6.3 报错：`No space left on device`