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

[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

[moha23]

@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

[SahilCarterr]

Hey @moha23 check #12438 it will be fixed