Documentation instructs installing diffusers from git causing version incompatibility with example requirements.txt (text to image lora) · Issue #12433 · huggingface/diffusers · GitHub
You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Documentation instructs installing diffusers from git causing version incompatibility with example requirements.txt (text to image lora) #12433
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:
@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
Activity
moha23 commentedon Oct 6, 2025
@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 commentedon Oct 6, 2025
Hey @moha23 check #12438 it will be fixed
JohnHerry commentedon Nov 14, 2025
Where is the requirements.txt file?
stevhliu commentedon Nov 14, 2025
You can find it in diffusers > examples > text_to_image here
JohnHerry commentedon Nov 17, 2025
thank you very much