ComfyUI HunyuanVideo-1.5 Plugin

A ComfyUI plugin based on HunyuanVideo-1.5, offering both simplified and complete node sets for quick usage or deep workflow customization.

---

✨ Features

• Simplified Nodes: Includes only the core Load Model and Inference nodes, ideal for quick testing and result preview.
• Complete Nodes: Provides more finely split nodes for detailed workflow adjustments and replacements.
• Auto-Download Models: Built-in automatic model download; no need to manually prepare model files (manual download also supported).

---

📦 Installation

Step 1: Install Dependencies

Install required libraries from requirements.txt: pip install -r requirements.txt

Step 2: Download Models

Choose one of the following methods to download the model files (including hunyuanvideo-1.5 model, text_encoder, and vision_encoder):

Method 1: Auto-Download (Recommended)

Enable the Auto-Download option in the plugin when running a workflow. Models will be automatically downloaded to the default path.

Method 2: Manual Download

Manually download the model files and place them into the plugin's specified model directory.Please refer to the checkpoints-download.md file in the HunyuanVideo-1.5 open-source project for details.

Step 3: Import Workflow

1. Import the provided example workflow file (e.g., simplified_I2V_workflow.json) into ComfyUI.
2. Adjust necessary parameters, such as selecting the model path and loading the image.
3. Tweak parameters or replace nodes as needed (the complete node set allows for more flexible adjustments).

---

🧩 Node Description

Simplified Nodes

• HyVideo15ModelLoader: Loads the HunyuanVideo-1.5 model.
• HyVideo15I2VSampler: Performs the video generation inference.

Complete Nodes

In addition to the simplified functionality, the complete set includes the following split nodes:

• HyVideoTextEncode: Text encoder.
• HyVideoVisionEncode: Image encoder.
• Refer to the example workflows for more details.

---

🛠 Usage Tips

• Start with the Simplified Workflow for initial use to quickly verify results.
• Switch to the Complete Nodes for flexible assembly if you need to customize generation logic (e.g., replace encoders, adjust frame sequences).
• Ensure a stable internet connection for auto-download. If download fails, check the path or manually download the models.

---

❓ FAQ

Q: What should I do if auto-download fails?
A: Check your network connection, or manually download the models and place them in the corresponding subdirectories under models/.

Q: How do I switch between Simplified and Complete versions?
A: Import the corresponding workflow file (e.g., simplified_I2V_workflow.json or complete_I2V_workflow.json) into ComfyUI. The nodes are grouped by version.

---

📄 License

This is an plugin based on the HunyuanVideo-1.5 model. Please comply with the relevant license agreement of the original model.