ComfyUI-HiDiffusion 开源项目安装与使用指南

项目概述

ComfyUI-HiDiffusion 是一个专为提升基于 SDXL, SDXL Turbo, SD 2.1 和 SD 1.5 模型的高分辨率图像生成而设计的自定义节点集。此项目利用了 HiDiffusion 技术，通过 Resolution-Aware U-Net（RAU-Net）动态调整特征图大小以减少对象重复，并采用优化的 Shifted Window Multi-head Self-Attention（MSW-MSA）来降低计算密集度，实现了在不增加训练成本的前提下，图像生成分辨率达到4096×4096，推理速度相比于传统方法提升了1.5到6倍。

目录结构及介绍

- main.py               # 主启动脚本，用于运行ComfyUI界面
- assets                # 资源文件夹，可能存放预训练模型或资源文件
- hidiffusion.py        # 包含HiDiffusion核心逻辑的Python文件
- utils.py              # 辅助函数集合，为项目提供通用功能
- README.md             # 项目说明文档，包含了快速入门和详细信息
- requirements.txt      # 依赖文件，虽然提到已移除，但正常项目中应有此文件指导环境搭建

请注意，上述requirements.txt提及被移除，实际使用时可能需要手动查找或根据错误信息安装必要的库。

项目的启动文件介绍

• main.py: 这是项目的主要执行入口点。启动ComfyUI环境时将调用这个文件。它负责加载界面、注册自定义节点并初始化整个应用。用户需确保其Python环境已准备就绪，并且满足所有必需的依赖项。

项目的配置文件介绍

由于具体项目没有明确指出存在独立的配置文件（如.yaml或.json），配置主要可能是通过代码内部参数设定或是环境变量来完成的。若要进行特定配置，例如修改模型路径或调整HiDiffusion节点的具体参数，可能需要直接编辑hidiffusion.py或其他相关Python脚本中的默认设置。对于复杂的配置需求，建议查看源码注释或贡献者提供的额外文档。

安装步骤简述

1. 克隆项目：首先从 GitHub 克隆项目到本地。

   git clone https://github.com/florestefano1975/ComfyUI-HiDiffusion.git
   

2. 环境准备：确保你的环境中已安装Python，并推荐创建一个新的虚拟环境来管理项目依赖。

   python -m venv env
   source env/bin/activate  # 对于Windows系统, 使用 activate
   

3. 安装缺失依赖：尽管原始项目中去除了requirements.txt，但可能需要手动安装一些基础库。你可能需要根据运行时的错误提示逐一安装。

4. 运行项目：进入项目目录，执行main.py以启动ComfyUI，期间注意任何打印出的日志信息，以解决潜在的依赖问题。

   cd ComfyUI-HiDiffusion
   python main.py
   

5. 配置和使用：在ComfyUI界面中找到新添加的HiDiffusion节点，根据项目文档或示例来进行个性化设置以生成高质量图像。

注意：开发状态的项目可能会伴随有bug或不稳定之处，因此强烈建议在正式使用前在一个测试环境中进行充分的验证。