Documentation instructs installing diffusers from git causing version incompatibility with example requirements.txt (text to image lora) · Issue #12433 · huggingface/diffusers · GitHub
Skip to content

Documentation instructs installing diffusers from git causing version incompatibility with example requirements.txt (text to image lora) #12433

Closed

Description

@moha23

Describe the bug

The official LoRA training tutorial/examples documentation instructs users to install diffusers from git, which installs the dev version. However, the requirements.txt files in the examples folders (examples/text_to_image/requirements.txt) specify outdated dependency versions like peft==0.7.0.

This creates an immediate import error because dev diffusers requires peft>=0.17.0, while the requirements.txt installs peft==0.7.0.

And further errors down the line even if peft is updated. (Error: TypeError: CLIPTextModel.init() got an unexpected keyword argument 'offload_state_dict' during running pipeline = StableDiffusionPipeline.from_pretrained("runwayml/stable-diffusion-v1-5", torch_dtype=torch.float16).to("cuda"))

Reproduction

# create new conda env
conda create -n lora python=3.10 -y
conda activate lora

# follow readme in examples/text_to_image

git clone https://github.com/huggingface/diffusers
cd diffusers
pip install .
pip install -r requirements.txt
accelerate config default


# Run the following in notebook
import torch
from diffusers import StableDiffusionPipeline


Error:

Traceback (most recent call last):
File "", line 1, in
File "/data2/a/miniconda3/envs/lora/lib/python3.10/site-packages/diffusers/init.py", line 5, in
from .utils import (
File "/data2/a/miniconda3/envs/lora/lib/python3.10/site-packages/diffusers/utils/init.py", line 21, in
from .constants import (
File "/data2/a/miniconda3/envs/lora/lib/python3.10/site-packages/diffusers/utils/constants.py", line 65, in
dep_version_check("peft")
File "/data2/a/miniconda3/envs/lora/lib/python3.10/site-packages/diffusers/dependency_versions_check.py", line 34, in dep_version_check
require_version(deps[pkg], hint)
File "/data2/a/miniconda3/envs/lora/lib/python3.10/site-packages/diffusers/utils/versions.py", line 111, in require_version
_compare_versions(op, got_ver, want_ver, requirement, pkg, hint)
File "/data2/a/miniconda3/envs/lora/lib/python3.10/site-packages/diffusers/utils/versions.py", line 44, in _compare_versions
raise ImportError(
ImportError: peft>=0.17.0 is required for a normal functioning of this module, but found peft==0.7.0.

Logs

Error:
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/data2/a/miniconda3/envs/lora/lib/python3.10/site-packages/diffusers/__init__.py", line 5, in <module>
    from .utils import (
  File "/data2/a/miniconda3/envs/lora/lib/python3.10/site-packages/diffusers/utils/__init__.py", line 21, in <module>
    from .constants import (
  File "/data2/a/miniconda3/envs/lora/lib/python3.10/site-packages/diffusers/utils/constants.py", line 65, in <module>
    dep_version_check("peft")
  File "/data2/a/miniconda3/envs/lora/lib/python3.10/site-packages/diffusers/dependency_versions_check.py", line 34, in dep_version_check
    require_version(deps[pkg], hint)
  File "/data2/a/miniconda3/envs/lora/lib/python3.10/site-packages/diffusers/utils/versions.py", line 111, in require_version
    _compare_versions(op, got_ver, want_ver, requirement, pkg, hint)
  File "/data2/a/miniconda3/envs/lora/lib/python3.10/site-packages/diffusers/utils/versions.py", line 44, in _compare_versions
    raise ImportError(
ImportError: peft>=0.17.0 is required for a normal functioning of this module, but found peft==0.7.0.


Even running diffusers-cli env throws error:

System Info

System Info

  • Python version: 3.10.18
  • PyTorch version: 2.8.0+cu128
  • CUDA version: 12.8
  • OS: Linux 5.15.0-139-generic
  • diffusers version: 0.36.0.dev0
  • peft version: 0.7.0
  • transformers version: 4.57.0
  • accelerate version: 1.10.1

Who can help?

@sayakpaul @stevhliu

Activity

  1. moha23 commented on Oct 6, 2025

    @moha23
    Author

    @SahilCarterr @sayakpaul the fix would still fail.. as i mentioned above, even with upgraded peft it further fails later.. i think someone opened new issue about it too

  2. SahilCarterr commented on Oct 6, 2025

    @SahilCarterr
    Contributor

    Hey @moha23 check #12438 it will be fixed

  3. JohnHerry commented on Nov 14, 2025

    @JohnHerry

    Where is the requirements.txt file?

  4. stevhliu commented on Nov 14, 2025

    @stevhliu
    Member

    You can find it in diffusers > examples > text_to_image here

  5. JohnHerry commented on Nov 17, 2025

    @JohnHerry

    thank you very much

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions