ComfyUI-HunyuanVideo-Avatar

By Yuan-ManXView on GitHub →

ComfyUI-HunyuanVideo-Avatar is now available in ComfyUI, HunyuanVideo-Avatar is a multimodal diffusion transformer (MM-DiT)-based model capable of simultaneously generating dynamic, emotion-controllable, and multi-character dialogue videos.

How much VRAM does ComfyUI-HunyuanVideo-Avatar require?

Direct Answer: The ComfyUI node ComfyUI-HunyuanVideo-Avatar requires a minimum base VRAM of 4096MB and is optimized for GPUs with at least 8GB of VRAM. Low VRAM mode is not supported for this node.

Very High (4-8GB)
Base VRAM:
4096MB (4.0GB)
Recommended GPU:
8GB+ VRAM
Low VRAM Mode:
✗ Not supported
Estimation Confidence:
MEDIUM

Interactive VRAM Compatibility Estimator

Estimated Total VRAM: 3.00 GBTarget: 8 GB
✅ Comfortable Fit

Your GPU has plenty of headroom. You can run this node safely with your active configurations!

Deploy on High-Performance GPUs

Need more VRAM to run ComfyUI with this node? Rent low-cost, high-performance GPUs on Vast.ai instantly.

🚀 Deploy on Vast.ai

Deploy on Cloud GPUs

Need more VRAM to run ComfyUI with this node? Rent low-cost, high-performance cloud GPUs on RunPod instantly.

🚀 Deploy on RunPod

What Python packages are required for ComfyUI-HunyuanVideo-Avatar?

Direct Answer: Running ComfyUI-HunyuanVideo-Avatar requires installing the following Python package dependencies: accelerate==1.1.1, decord==0.6.0, diffusers==0.33.0, einops==0.7.0, fastapi==0.115.12, ffmpeg, gradio==4.42.0, imageio==2.34.0, imageio-ffmpeg==0.5.1, librosa==0.11.0, loguru==0.7.2, numpy==1.24.4, opencv-python==4.9.0.80, pandas==2.0.3, safetensors==0.4.3, scikit-video==1.1.11, tqdm==4.66.2, transformers==4.45.1, uvicorn==0.34.2. Ensure your ComfyUI environment has these packages active before launching.

requirements.txt
accelerate==1.1.1
decord==0.6.0
diffusers==0.33.0
einops==0.7.0
fastapi==0.115.12
ffmpeg
gradio==4.42.0
imageio==2.34.0
imageio-ffmpeg==0.5.1
librosa==0.11.0
loguru==0.7.2
numpy==1.24.4
opencv-python==4.9.0.80
pandas==2.0.3
safetensors==0.4.3
scikit-video==1.1.11
tqdm==4.66.2
transformers==4.45.1
uvicorn==0.34.2

Interactive Setup & Dependency Resolver

Operating System:
Environment Type:
Run this terminal command in your ComfyUI root folder:
# Loading command...

Compatible Foundations

This node is verified to support or optimize workflows for the following foundation model families:

Frequently Asked Questions

How much VRAM does ComfyUI-HunyuanVideo-Avatar require?

ComfyUI-HunyuanVideo-Avatar requires a minimum of 4096MB (4.0GB) of VRAM for base operation. For optimal performance, a GPU with at least 8GB of VRAM is recommended. Low VRAM mode is not supported for this node.

Can I run ComfyUI-HunyuanVideo-Avatar on an RTX 3060, RTX 4070, or RTX 4090?

✅ RTX 3060 (12GB): Yes, fully compatible with 6.8GB headroom. ✅ RTX 4070 (12GB): Yes, fully compatible with 6.8GB headroom. ✅ RTX 4070 Ti (16GB): Yes, fully compatible with 10.4GB headroom. ✅ RTX 4090 (24GB): Yes, fully compatible with 17.6GB headroom

What Python packages are required for ComfyUI-HunyuanVideo-Avatar?

To run ComfyUI-HunyuanVideo-Avatar, you need to install: accelerate==1.1.1, decord==0.6.0, diffusers==0.33.0, einops==0.7.0, fastapi==0.115.12, ffmpeg, gradio==4.42.0, imageio==2.34.0, imageio-ffmpeg==0.5.1, librosa==0.11.0, loguru==0.7.2, numpy==1.24.4, opencv-python==4.9.0.80, pandas==2.0.3, safetensors==0.4.3, scikit-video==1.1.11, tqdm==4.66.2, transformers==4.45.1, uvicorn==0.34.2. You can install these using pip or add them to your requirements.txt file.

How do I install ComfyUI-HunyuanVideo-Avatar in ComfyUI?

To install ComfyUI-HunyuanVideo-Avatar: (1) Navigate to your ComfyUI/custom_nodes directory, (2) Clone the repository: git clone https://github.com/Yuan-ManX/ComfyUI-HunyuanVideo-Avatar, (3) Install dependencies: pip install -r requirements.txt (if present), (4) Restart ComfyUI. Alternatively, use ComfyUI Manager for one-click installation.