comfyui本地部署需依次完成环境准备、克隆仓库、安装依赖、启动服务及路径配置:先确保python 3.10–3.12和git已安装并加入path;再克隆官方仓库;接着pip安装requirements.txt依赖;然后运行python main.py --listen启动服务;最后配置models等独立存储路径。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜

如果您希望在本地计算机上运行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... 提示确认生效。










