README.md

ComfyUI-HunyuanVideoImagesGuider

A specialized node for ComfyUI that enable motion and animation capabilities for image as guider for video processing In Hunyuan Video T2V model weights.

How to use this node , you can check it out in this video : https://youtu.be/fq95OLDVCdU

Features

Hunyuan Video Image To Guider

• Smooth camera panning effects (X and Y axis)
• Zoom in/out animations
• Seamless image tiling and repetition
• Customizable frame count and motion strength
• Support for various resize modes
• Optional center cropping

Installation

1. Clone this repository into your ComfyUI custom nodes directory:

cd ComfyUI/custom_nodes
git clone https://github.com/benjiyaya/ComfyUI-HunyuanVideoImagesGuider.git

2. Restart ComfyUI to load the new nodes

Usage

Hunyuan Video Image To Guider

Parameters:

• image: Input image
• move_range_x: Horizontal motion range (-1.0 to 1.0) (Best range in -0.05 - 0.05)
• move_range_y: Vertical motion range (-1.0 to 1.0) (Best range in -0.05 - 0.05)
• zoom: Zoom effect strength (0.0 to 0.5)
• frame_num: Number of frames to generate (2-150)
• resize_mode: Image resize options (disabled/custom/keep_ratio)
• target_width: Custom width for resize
• target_height: Custom height for resize
• center_crop: Enable/disable center cropping

*** For the sampler denoise, good range in 0.7-0.9 , below 0.5 almost no animation for object.

Technical Details

The nodes utilize PyTorch for efficient tensor operations and implement various optimization techniques:

• Automatic mixed precision
• Efficient memory management
• Batched processing
• Error handling and recovery
• Progress tracking

2.mp4

3.mp4

4-b.mp4

hyvideo_img2vid_output_00025.mp4

hyvideo_img2vid_output_00017.mp4

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - feel free to use in your own projects.

Credits

Created by Benji and DeepSeek AI Copilot