ComfyUI本地部署需依次完成环境准备、克隆仓库、安装依赖、启动服务及路径配置：先确保Python 3.10–3.12和Git已安装并加入PATH；再克隆官方仓库；接着pip安装requirements.txt依赖；然后运行python main.py --listen启动服务；最后配置models等独立存储路径。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望在本地计算机上运行ComfyUI，但尚未完成环境初始化与主程序部署，则可能是由于缺少Python运行时、Git工具或未正确执行克隆与依赖安装流程。以下是完成ComfyUI本地部署的完整步骤：

一、准备基础运行环境

ComfyUI依赖Python 3.10–3.12及Git命令行工具，缺失任一组件将导致后续克隆失败或依赖安装中断。系统需预先验证这两个核心组件的可用性与版本兼容性。

1、打开终端（Windows用户使用PowerShell或CMD，macOS/Linux用户使用Terminal）。

2、输入 python --version 检查Python版本，若未安装或版本低于3.10，请前往python.org下载并安装Python 3.11.x（推荐）。

3、输入 git --version 验证Git是否已安装；若提示“command not found”，请访问git-scm.com下载安装最新版Git。

4、确保Python安装时勾选了“Add Python to PATH”选项，否则需手动将Python及Scripts目录加入系统环境变量。

二、克隆ComfyUI主程序仓库

该步骤从官方GitHub仓库获取最新稳定版ComfyUI源码，所有功能模块与默认工作流均由此目录启动。必须在目标安装路径下执行克隆操作，避免路径嵌套错误。

1、在终端中切换至期望安装目录，例如：cd D:\AI\comfyui（Windows）或 cd ~/comfyui（macOS/Linux）。

2、执行克隆命令：git clone https://github.com/comfyanonymous/ComfyUI.git。

3、等待下载完成，确认当前目录下生成 ComfyUI 子文件夹，其内部包含 main.py、requirements.txt 等关键文件。

三、安装Python依赖包

ComfyUI运行依赖约30+个第三方库（如torch、numpy、Pillow），需通过pip批量安装。使用--ignore-installed参数可规避已有系统级包冲突，保障环境纯净性。

1、进入ComfyUI根目录：cd ComfyUI。

2、执行依赖安装命令：pip install -r requirements.txt --ignore-installed。

3、若出现CUDA相关报错（如torch版本不匹配），请先卸载现有torch：pip uninstall torch torchvision torchaudio，再根据显卡型号安装对应CUDA版本的torch（参考pytorch.org）。

四、启动ComfyUI服务

启动过程将初始化Web服务器、加载默认节点库，并绑定本地监听地址。默认端口为8188，支持局域网内其他设备通过IP访问（需开启防火墙放行）。

1、确保仍在ComfyUI根目录，执行启动命令：python main.py --listen。

2、终端输出日志中出现 Starting server 及 To see the GUI go to: http://0.0.0.0:8188 表示服务已就绪。

3、在浏览器中访问 http://127.0.0.1:8188，加载成功即显示ComfyUI工作流编辑界面。

五、配置存储路径与模型目录

默认情况下，模型文件（Checkpoint）、插件（Custom Nodes）及输出图片均存于ComfyUI根目录下，易造成空间占用混乱。建议显式指定独立路径，提升可维护性与跨设备迁移能力。

1、在ComfyUI根目录新建文件夹：models（用于存放所有模型）、custom_nodes（用于插件）、output（用于生成结果）。

2、编辑 ComfyUI/startup_script.py（若不存在则新建），添加以下两行：

import os

os.environ['COMFYUI_MODEL_PATH'] = 'D:/AI/comfyui/models'（路径按实际修改）

3、重启ComfyUI服务，新路径将在日志中以 Model path set to... 提示确认生效。