ComfyUI纯净版安装教程:从源码构建到加速组件配置全流程
ComfyUI作为一款强大的模块化Stable Diffusion GUI,其灵活性吸引了大量用户。相比于便携包或桌面版,通过Git从仓库拉取源代码进行手动安装,能够获得更高的环境自由度与更简单的排查机制。本文将详细介绍在Windows系统下,从环境准备、源码拉取、虚拟环境配置,到PyTorch及加速组件安装的全过程,帮助用户搭建一个纯净且高性能的ComfyUI运行环境。
01前置环境准备
- 安装Git工具
访问Git官网下载Windows版本并安装,一路点击“下一步”直至完成。这是后续克隆代码仓库的基础工具。 - 安装Python 3.12
下载Python 3.12.6(64位)版本。安装界面中务必勾选“Add Python to PATH”选项,将其添加到系统环境变量中。选择3.12而非3.13版本,主要是为了确保对各类插件的兼容性。 - 更新显卡驱动
确保显卡驱动已升级至最新版本(如NVIDIA 596.xx系列),以保证CUDA的正常调用。 - 安装CUDA 12.8
下载并安装CUDA 12.8版本。避免使用最新的13.2版本,以防止部分插件无法支持。安装完成后可通过终端输入`nvcc --version`验证。
02源码克隆与虚拟环境配置
在固态硬盘中新建一个无中文字符的文件夹作为工作目录。在该目录下打开终端(管理员权限),使用Git命令克隆ComfyUI官方仓库。随后,创建独立的Python虚拟环境,避免与系统环境产生冲突。
- 克隆源代码
在终端执行以下命令:git clone https://github.com/comfyanonymous/ComfyUI.git - 创建并激活虚拟环境
进入ComfyUI目录下的venv文件夹,执行激活命令:cd ComfyUI/venv/Scriptsactivate
成功后终端路径前会出现绿色的(venv)标识。 - 安装基础依赖
返回ComfyUI根目录,安装requirements.txt中的依赖库:cd ../..pip install -r requirements.txt
03PyTorch及加速组件安装
为了获得更快的推理速度,需要安装特定版本的PyTorch以及SageAttention和Flash Attention两大加速组件。安装这些组件需要严格对应Python和CUDA的版本。
| 组件名称 | 对应版本 | 安装方式 |
|---|---|---|
| PyTorch | 2.8.0 + cu128 | pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu128 |
| Triton | 2.4.0 (需VS Build Tools) | pip install triton==2.4.0 |
| SageAttention | 2.2.2 (cp312) | 本地下载whl文件后,执行 pip install 文件名.whl |
| Flash Attention | 2.8.3 (cu128) | 本地下载whl文件后,执行 pip install 文件名.whl |
核心组件版本对应关系
需要注意的是,安装Triton前需先下载并安装Visual Studio Build Tools,安装完成后需重启电脑。SageAttention和Flash Attention建议直接从GitHub或相关镜像站下载预编译的.whl文件(适配Python 3.12和CUDA 12.8),放置在ComfyUI根目录下,通过pip命令本地安装,以避免编译耗时和报错。
04ComfyUI Manager安装与启动验证
- 安装插件管理器
进入custom_nodes目录,克隆Manager仓库:cd custom_nodesgit clone https://github.com/ltdrdata/ComfyUI-Manager.git - 启动ComfyUI
返回根目录,运行主程序:cd ..python main.py
终端显示Running on http://127.0.0.1:8188即表示启动成功。 - 验证与生成
将浏览器访问本地8188端口,放入模型文件,加载默认工作流进行图像生成测试。若能正常出图,说明环境配置无误。
对于日常启动,建议创建一个批处理脚本(.bat)文件,内容依次为激活虚拟环境和启动main.py的命令,以便双击直接运行。部分用户反馈若遇到执行策略限制,可在PowerShell中先输入`Set-ExecutionPolicy RemoteSigned -Scope Process`绕过限制。
当前文章无评论,是时候发表评论了