huggingface / huggingface/diffusers
[Feature Request] Add LoRA loading support for HunyuanVideo 1.5
- 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
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