huggingface / huggingface/diffusers

[Feature Request] Add LoRA loading support for HunyuanVideo 1.5

Open
#14,420 0 comments 0 reactions 0 assignees View on GitHub
feature-request lora pipelines
Dominant language
Python
Stars
34.5k
Forks
7.3k
Avg merge
3d 3h
Merged PRs (30d)
91

Description

**What does this feature request propose?**

HunyuanVideo 1.5 was recently added to diffusers with two pipelines:
- `HunyuanVideo15Pipeline` (text-to-video)
- `HunyuanVideo15ImageToVideoPipeline` (image-to-video)

However, neither pipeline has LoRA support. Both classes currently inherit only from `DiffusionPipeline` with no `LoraLoaderMixin`.

HunyuanVideo v1 already has `HunyuanVideoLoraLoaderMixin` covering its pipelines, but that mixin explicitly targets `HunyuanVideoTransformer3DModel`. HunyuanVideo 1.5 uses a distinct `HunyuanVideo15Transformer3DModel`, so it cannot reuse the v1 mixin directly.

**Proposed implementation**

- Add `HunyuanVideo15LoraLoaderMixin` to `src/diffusers/loaders/lora_pipeline.py`, modelled after the existing `HunyuanVideoLoraLoaderMixin` but targeting `HunyuanVideo15Transformer3DModel`
- Wire both `HunyuanVideo15Pipeline` and `HunyuanVideo15ImageToVideoPipeline` to inherit from it
- Export the new mixin from `src/diffusers/loaders/__init__.py`
- Add tests mirroring the existing HunyuanVideo LoRA test coverage

**Why is this needed?**

HunyuanVideo has a large and active fine-tuning community. LoRA training for 1.5 is already happening in tools like ai-toolkit and ComfyUI. Without a standard loader in diffusers, users have no clean path to load those LoRAs through the library.

**Who can review?**
`@sayakpaul` `@DN6` `@yiyixuxu`

**Are you willing to contribute?**
Yes, happy to open a PR if the approach looks reasonable.

Contributor guide

Open the contributing guide

Research direction

Start with HunyunVideoLoraLoaderMixin in src/diffusers/loaders/lora_pipeline.py and compare the HunyuanVideo 1.5 pipeline classes. Trace the existing HunyuanVideo LoRA tests, then add matching coverage for both pipelines and verify the new mixin is exported from src/diffusers/loaders/__init__.py; done means both pipelines can load HunyuanVideo 1.5 LoRAs through the standard loader.

Written by the indexing model from the issue text.

Assessment

Tech stack
python, pytorch
Domain
machine-learning, testing-qa
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
72/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.