diffusers 0.28.2__py3-none-any.whl → 0.29.0__py3-none-any.whl

diffusers/training_utils.py

@@ -157,19 +157,19 @@ def compute_dream_and_update_latents(
     with torch.no_grad():
         pred = unet(noisy_latents, timesteps, encoder_hidden_states).sample
 
-    noisy_latents, target = (None, None)
+    _noisy_latents, _target = (None, None)
     if noise_scheduler.config.prediction_type == "epsilon":
         predicted_noise = pred
         delta_noise = (noise - predicted_noise).detach()
         delta_noise.mul_(dream_lambda)
-        noisy_latents = noisy_latents.add(sqrt_one_minus_alphas_cumprod * delta_noise)
-        target = target.add(delta_noise)
+        _noisy_latents = noisy_latents.add(sqrt_one_minus_alphas_cumprod * delta_noise)
+        _target = target.add(delta_noise)
     elif noise_scheduler.config.prediction_type == "v_prediction":
         raise NotImplementedError("DREAM has not been implemented for v-prediction")
     else:
         raise ValueError(f"Unknown prediction type {noise_scheduler.config.prediction_type}")
 
-    return noisy_latents, target
+    return _noisy_latents, _target
 
 
 def unet_lora_state_dict(unet: UNet2DConditionModel) -> Dict[str, torch.Tensor]:

diffusers/utils/__init__.py

@@ -28,9 +28,11 @@ from .constants import (
     MIN_PEFT_VERSION,
     ONNX_EXTERNAL_WEIGHTS_NAME,
     ONNX_WEIGHTS_NAME,
+    SAFE_WEIGHTS_INDEX_NAME,
     SAFETENSORS_FILE_EXTENSION,
     SAFETENSORS_WEIGHTS_NAME,
     USE_PEFT_BACKEND,
+    WEIGHTS_INDEX_NAME,
     WEIGHTS_NAME,
 )
 from .deprecation_utils import deprecate
@@ -40,6 +42,7 @@ from .export_utils import export_to_gif, export_to_obj, export_to_ply, export_to
 from .hub_utils import (
     PushToHubMixin,
     _add_variant,
+    _get_checkpoint_shard_files,
     _get_model_file,
     extract_commit_hash,
     http_user_agent,

diffusers/utils/constants.py

@@ -28,9 +28,11 @@ _CHECK_PEFT = os.environ.get("_CHECK_PEFT", "1") in ENV_VARS_TRUE_VALUES
 
 CONFIG_NAME = "config.json"
 WEIGHTS_NAME = "diffusion_pytorch_model.bin"
+WEIGHTS_INDEX_NAME = "diffusion_pytorch_model.bin.index.json"
 FLAX_WEIGHTS_NAME = "diffusion_flax_model.msgpack"
 ONNX_WEIGHTS_NAME = "model.onnx"
 SAFETENSORS_WEIGHTS_NAME = "diffusion_pytorch_model.safetensors"
+SAFE_WEIGHTS_INDEX_NAME = "diffusion_pytorch_model.safetensors.index.json"
 SAFETENSORS_FILE_EXTENSION = "safetensors"
 ONNX_EXTERNAL_WEIGHTS_NAME = "weights.pb"
 HUGGINGFACE_CO_RESOLVE_ENDPOINT = os.environ.get("HF_ENDPOINT", "https://huggingface.co")

diffusers/utils/dummy_pt_objects.py

@@ -242,6 +242,21 @@ class PriorTransformer(metaclass=DummyObject):
         requires_backends(cls, ["torch"])
 
 
+class SD3Transformer2DModel(metaclass=DummyObject):
+    _backends = ["torch"]
+
+    def __init__(self, *args, **kwargs):
+        requires_backends(self, ["torch"])
+
+    @classmethod
+    def from_config(cls, *args, **kwargs):
+        requires_backends(cls, ["torch"])
+
+    @classmethod
+    def from_pretrained(cls, *args, **kwargs):
+        requires_backends(cls, ["torch"])
+
+
 class T2IAdapter(metaclass=DummyObject):
     _backends = ["torch"]
 
@@ -1005,6 +1020,21 @@ class EulerDiscreteScheduler(metaclass=DummyObject):
         requires_backends(cls, ["torch"])
 
 
+class FlowMatchEulerDiscreteScheduler(metaclass=DummyObject):
+    _backends = ["torch"]
+
+    def __init__(self, *args, **kwargs):
+        requires_backends(self, ["torch"])
+
+    @classmethod
+    def from_config(cls, *args, **kwargs):
+        requires_backends(cls, ["torch"])
+
+    @classmethod
+    def from_pretrained(cls, *args, **kwargs):
+        requires_backends(cls, ["torch"])
+
+
 class HeunDiscreteScheduler(metaclass=DummyObject):
     _backends = ["torch"]
 

diffusers/utils/dummy_torch_and_transformers_objects.py

@@ -902,6 +902,36 @@ class StableCascadePriorPipeline(metaclass=DummyObject):
         requires_backends(cls, ["torch", "transformers"])
 
 
+class StableDiffusion3Img2ImgPipeline(metaclass=DummyObject):
+    _backends = ["torch", "transformers"]
+
+    def __init__(self, *args, **kwargs):
+        requires_backends(self, ["torch", "transformers"])
+
+    @classmethod
+    def from_config(cls, *args, **kwargs):
+        requires_backends(cls, ["torch", "transformers"])
+
+    @classmethod
+    def from_pretrained(cls, *args, **kwargs):
+        requires_backends(cls, ["torch", "transformers"])
+
+
+class StableDiffusion3Pipeline(metaclass=DummyObject):
+    _backends = ["torch", "transformers"]
+
+    def __init__(self, *args, **kwargs):
+        requires_backends(self, ["torch", "transformers"])
+
+    @classmethod
+    def from_config(cls, *args, **kwargs):
+        requires_backends(cls, ["torch", "transformers"])
+
+    @classmethod
+    def from_pretrained(cls, *args, **kwargs):
+        requires_backends(cls, ["torch", "transformers"])
+
+
 class StableDiffusionAdapterPipeline(metaclass=DummyObject):
     _backends = ["torch", "transformers"]
 

diffusers/utils/dynamic_modules_utils.py

@@ -25,21 +25,19 @@ from pathlib import Path
 from typing import Dict, Optional, Union
 from urllib import request
 
-from huggingface_hub import cached_download, hf_hub_download, model_info
-from huggingface_hub.utils import validate_hf_hub_args
+from huggingface_hub import hf_hub_download, model_info
+from huggingface_hub.utils import RevisionNotFoundError, validate_hf_hub_args
 from packaging import version
 
 from .. import __version__
 from . import DIFFUSERS_DYNAMIC_MODULE_NAME, HF_MODULES_CACHE, logging
 
 
-COMMUNITY_PIPELINES_URL = (
-    "https://raw.githubusercontent.com/huggingface/diffusers/{revision}/examples/community/{pipeline}.py"
-)
-
-
 logger = logging.get_logger(__name__)  # pylint: disable=invalid-name
 
+# See https://huggingface.co/datasets/diffusers/community-pipelines-mirror
+COMMUNITY_PIPELINES_MIRROR_ID = "diffusers/community-pipelines-mirror"
+
 
 def get_diffusers_versions():
     url = "https://pypi.org/pypi/diffusers/json"
@@ -281,20 +279,24 @@ def get_cached_module_file(
                 f" {', '.join(available_versions + ['main'])}."
             )
 
-        # community pipeline on GitHub
-        github_url = COMMUNITY_PIPELINES_URL.format(revision=revision, pipeline=pretrained_model_name_or_path)
         try:
-            resolved_module_file = cached_download(
-                github_url,
+            resolved_module_file = hf_hub_download(
+                repo_id=COMMUNITY_PIPELINES_MIRROR_ID,
+                repo_type="dataset",
+                filename=f"{revision}/{pretrained_model_name_or_path}.py",
                 cache_dir=cache_dir,
                 force_download=force_download,
                 proxies=proxies,
-                resume_download=resume_download,
                 local_files_only=local_files_only,
-                token=False,
             )
             submodule = "git"
             module_file = pretrained_model_name_or_path + ".py"
+        except RevisionNotFoundError as e:
+            raise EnvironmentError(
+                f"Revision '{revision}' not found in the community pipelines mirror. Check available revisions on"
+                " https://huggingface.co/datasets/diffusers/community-pipelines-mirror/tree/main."
+                " If you don't find the revision you are looking for, please open an issue on https://github.com/huggingface/diffusers/issues."
+            ) from e
         except EnvironmentError:
             logger.error(f"Could not locate the {module_file} inside {pretrained_model_name_or_path}.")
             raise

diffusers/utils/hub_utils.py

@@ -14,6 +14,7 @@
 # limitations under the License.
 
 
+import json
 import os
 import re
 import sys
@@ -29,6 +30,8 @@ from huggingface_hub import (
     ModelCardData,
     create_repo,
     hf_hub_download,
+    model_info,
+    snapshot_download,
     upload_folder,
 )
 from huggingface_hub.constants import HF_HUB_CACHE, HF_HUB_DISABLE_TELEMETRY, HF_HUB_OFFLINE
@@ -393,6 +396,109 @@ def _get_model_file(
             )
 
 
+# Adapted from
+# https://github.com/huggingface/transformers/blob/1360801a69c0b169e3efdbb0cd05d9a0e72bfb70/src/transformers/utils/hub.py#L976
+# Differences are in parallelization of shard downloads and checking if shards are present.
+
+
+def _check_if_shards_exist_locally(local_dir, subfolder, original_shard_filenames):
+    shards_path = os.path.join(local_dir, subfolder)
+    shard_filenames = [os.path.join(shards_path, f) for f in original_shard_filenames]
+    for shard_file in shard_filenames:
+        if not os.path.exists(shard_file):
+            raise ValueError(
+                f"{shards_path} does not appear to have a file named {shard_file} which is "
+                "required according to the checkpoint index."
+            )
+
+
+def _get_checkpoint_shard_files(
+    pretrained_model_name_or_path,
+    index_filename,
+    cache_dir=None,
+    proxies=None,
+    resume_download=False,
+    local_files_only=False,
+    token=None,
+    user_agent=None,
+    revision=None,
+    subfolder="",
+):
+    """
+    For a given model:
+
+    - download and cache all the shards of a sharded checkpoint if `pretrained_model_name_or_path` is a model ID on the
+      Hub
+    - returns the list of paths to all the shards, as well as some metadata.
+
+    For the description of each arg, see [`PreTrainedModel.from_pretrained`]. `index_filename` is the full path to the
+    index (downloaded and cached if `pretrained_model_name_or_path` is a model ID on the Hub).
+    """
+    if not os.path.isfile(index_filename):
+        raise ValueError(f"Can't find a checkpoint index ({index_filename}) in {pretrained_model_name_or_path}.")
+
+    with open(index_filename, "r") as f:
+        index = json.loads(f.read())
+
+    original_shard_filenames = sorted(set(index["weight_map"].values()))
+    sharded_metadata = index["metadata"]
+    sharded_metadata["all_checkpoint_keys"] = list(index["weight_map"].keys())
+    sharded_metadata["weight_map"] = index["weight_map"].copy()
+    shards_path = os.path.join(pretrained_model_name_or_path, subfolder)
+
+    # First, let's deal with local folder.
+    if os.path.isdir(pretrained_model_name_or_path):
+        _check_if_shards_exist_locally(
+            pretrained_model_name_or_path, subfolder=subfolder, original_shard_filenames=original_shard_filenames
+        )
+        return pretrained_model_name_or_path, sharded_metadata
+
+    # At this stage pretrained_model_name_or_path is a model identifier on the Hub
+    allow_patterns = original_shard_filenames
+    ignore_patterns = ["*.json", "*.md"]
+    if not local_files_only:
+        # `model_info` call must guarded with the above condition.
+        model_files_info = model_info(pretrained_model_name_or_path)
+        for shard_file in original_shard_filenames:
+            shard_file_present = any(shard_file in k.rfilename for k in model_files_info.siblings)
+            if not shard_file_present:
+                raise EnvironmentError(
+                    f"{shards_path} does not appear to have a file named {shard_file} which is "
+                    "required according to the checkpoint index."
+                )
+
+    try:
+        # Load from URL
+        cached_folder = snapshot_download(
+            pretrained_model_name_or_path,
+            cache_dir=cache_dir,
+            resume_download=resume_download,
+            proxies=proxies,
+            local_files_only=local_files_only,
+            token=token,
+            revision=revision,
+            allow_patterns=allow_patterns,
+            ignore_patterns=ignore_patterns,
+            user_agent=user_agent,
+        )
+
+    # We have already dealt with RepositoryNotFoundError and RevisionNotFoundError when getting the index, so
+    # we don't have to catch them here. We have also dealt with EntryNotFoundError.
+    except HTTPError as e:
+        raise EnvironmentError(
+            f"We couldn't connect to '{HUGGINGFACE_CO_RESOLVE_ENDPOINT}' to load {pretrained_model_name_or_path}. You should try"
+            " again after checking your internet connection."
+        ) from e
+
+    # If `local_files_only=True`, `cached_folder` may not contain all the shard files.
+    if local_files_only:
+        _check_if_shards_exist_locally(
+            local_dir=cache_dir, subfolder=subfolder, original_shard_filenames=original_shard_filenames
+        )
+
+    return cached_folder, sharded_metadata
+
+
 class PushToHubMixin:
     """
     A Mixin to push a model, scheduler, or pipeline to the Hugging Face Hub.

diffusers/utils/import_utils.py

@@ -131,7 +131,6 @@ try:
 except importlib_metadata.PackageNotFoundError:
     _unidecode_available = False
 
-
 _onnxruntime_version = "N/A"
 _onnx_available = importlib.util.find_spec("onnxruntime") is not None
 if _onnx_available:

diffusers/utils/logging.py

@@ -82,7 +82,9 @@ def _configure_library_root_logger() -> None:
             # This library has already configured the library root logger.
             return
         _default_handler = logging.StreamHandler()  # Set sys.stderr as stream.
-        _default_handler.flush = sys.stderr.flush
+
+        if sys.stderr:  # only if sys.stderr exists, e.g. when not using pythonw in windows
+            _default_handler.flush = sys.stderr.flush
 
         # Apply our default configuration to the library root logger.
         library_root_logger = _get_library_root_logger()

diffusers/utils/state_dict_utils.py

@@ -62,6 +62,8 @@ DIFFUSERS_TO_PEFT = {
     ".out_proj.lora_linear_layer.down": ".out_proj.lora_A",
     ".lora_linear_layer.up": ".lora_B",
     ".lora_linear_layer.down": ".lora_A",
+    "text_projection.lora.down.weight": "text_projection.lora_A.weight",
+    "text_projection.lora.up.weight": "text_projection.lora_B.weight",
 }
 
 DIFFUSERS_OLD_TO_PEFT = {

{diffusers-0.28.2.dist-info → diffusers-0.29.0.dist-info}/METADATA

@@ -1,10 +1,10 @@
 Metadata-Version: 2.1
 Name: diffusers
-Version: 0.28.2
+Version: 0.29.0
 Summary: State-of-the-art diffusion in PyTorch and JAX.
 Home-page: https://github.com/huggingface/diffusers
 Author: The Hugging Face team (past and future) with the help of all our contributors (https://github.com/huggingface/diffusers/graphs/contributors)
-Author-email: patrick@huggingface.co
+Author-email: diffusers@huggingface.co
 License: Apache 2.0 License
 Keywords: deep learning diffusion jax pytorch stable diffusion audioldm
 Classifier: Development Status :: 5 - Production/Stable
@@ -23,81 +23,81 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: importlib-metadata
 Requires-Dist: filelock
-Requires-Dist: huggingface-hub >=0.20.2
+Requires-Dist: huggingface-hub (>=0.23.2)
 Requires-Dist: numpy
-Requires-Dist: regex !=2019.12.17
+Requires-Dist: regex (!=2019.12.17)
 Requires-Dist: requests
-Requires-Dist: safetensors >=0.3.1
+Requires-Dist: safetensors (>=0.3.1)
 Requires-Dist: Pillow
 Provides-Extra: dev
-Requires-Dist: urllib3 <=2.0.0 ; extra == 'dev'
-Requires-Dist: isort >=5.5.4 ; extra == 'dev'
-Requires-Dist: ruff ==0.1.5 ; extra == 'dev'
-Requires-Dist: hf-doc-builder >=0.3.0 ; extra == 'dev'
-Requires-Dist: compel ==0.1.8 ; extra == 'dev'
-Requires-Dist: GitPython <3.1.19 ; extra == 'dev'
+Requires-Dist: urllib3 (<=2.0.0) ; extra == 'dev'
+Requires-Dist: isort (>=5.5.4) ; extra == 'dev'
+Requires-Dist: ruff (==0.1.5) ; extra == 'dev'
+Requires-Dist: hf-doc-builder (>=0.3.0) ; extra == 'dev'
+Requires-Dist: compel (==0.1.8) ; extra == 'dev'
+Requires-Dist: GitPython (<3.1.19) ; extra == 'dev'
 Requires-Dist: datasets ; extra == 'dev'
 Requires-Dist: Jinja2 ; extra == 'dev'
-Requires-Dist: invisible-watermark >=0.2.0 ; extra == 'dev'
-Requires-Dist: k-diffusion >=0.0.12 ; extra == 'dev'
+Requires-Dist: invisible-watermark (>=0.2.0) ; extra == 'dev'
+Requires-Dist: k-diffusion (>=0.0.12) ; extra == 'dev'
 Requires-Dist: librosa ; extra == 'dev'
 Requires-Dist: parameterized ; extra == 'dev'
 Requires-Dist: pytest ; extra == 'dev'
 Requires-Dist: pytest-timeout ; extra == 'dev'
 Requires-Dist: pytest-xdist ; extra == 'dev'
-Requires-Dist: requests-mock ==1.10.0 ; extra == 'dev'
-Requires-Dist: safetensors >=0.3.1 ; extra == 'dev'
-Requires-Dist: sentencepiece !=0.1.92,>=0.1.91 ; extra == 'dev'
+Requires-Dist: requests-mock (==1.10.0) ; extra == 'dev'
+Requires-Dist: safetensors (>=0.3.1) ; extra == 'dev'
+Requires-Dist: sentencepiece (!=0.1.92,>=0.1.91) ; extra == 'dev'
 Requires-Dist: scipy ; extra == 'dev'
 Requires-Dist: torchvision ; extra == 'dev'
-Requires-Dist: transformers >=4.25.1 ; extra == 'dev'
-Requires-Dist: accelerate >=0.29.3 ; extra == 'dev'
-Requires-Dist: protobuf <4,>=3.20.3 ; extra == 'dev'
+Requires-Dist: transformers (>=4.25.1) ; extra == 'dev'
+Requires-Dist: accelerate (>=0.29.3) ; extra == 'dev'
+Requires-Dist: protobuf (<4,>=3.20.3) ; extra == 'dev'
 Requires-Dist: tensorboard ; extra == 'dev'
-Requires-Dist: peft >=0.6.0 ; extra == 'dev'
-Requires-Dist: torch >=1.4 ; extra == 'dev'
-Requires-Dist: jax >=0.4.1 ; extra == 'dev'
-Requires-Dist: jaxlib >=0.4.1 ; extra == 'dev'
-Requires-Dist: flax >=0.4.1 ; extra == 'dev'
+Requires-Dist: peft (>=0.6.0) ; extra == 'dev'
+Requires-Dist: torch (>=1.4) ; extra == 'dev'
+Requires-Dist: jax (>=0.4.1) ; extra == 'dev'
+Requires-Dist: jaxlib (>=0.4.1) ; extra == 'dev'
+Requires-Dist: flax (>=0.4.1) ; extra == 'dev'
 Provides-Extra: docs
-Requires-Dist: hf-doc-builder >=0.3.0 ; extra == 'docs'
+Requires-Dist: hf-doc-builder (>=0.3.0) ; extra == 'docs'
 Provides-Extra: flax
-Requires-Dist: jax >=0.4.1 ; extra == 'flax'
-Requires-Dist: jaxlib >=0.4.1 ; extra == 'flax'
-Requires-Dist: flax >=0.4.1 ; extra == 'flax'
+Requires-Dist: jax (>=0.4.1) ; extra == 'flax'
+Requires-Dist: jaxlib (>=0.4.1) ; extra == 'flax'
+Requires-Dist: flax (>=0.4.1) ; extra == 'flax'
 Provides-Extra: quality
-Requires-Dist: urllib3 <=2.0.0 ; extra == 'quality'
-Requires-Dist: isort >=5.5.4 ; extra == 'quality'
-Requires-Dist: ruff ==0.1.5 ; extra == 'quality'
-Requires-Dist: hf-doc-builder >=0.3.0 ; extra == 'quality'
+Requires-Dist: urllib3 (<=2.0.0) ; extra == 'quality'
+Requires-Dist: isort (>=5.5.4) ; extra == 'quality'
+Requires-Dist: ruff (==0.1.5) ; extra == 'quality'
+Requires-Dist: hf-doc-builder (>=0.3.0) ; extra == 'quality'
 Provides-Extra: test
-Requires-Dist: compel ==0.1.8 ; extra == 'test'
-Requires-Dist: GitPython <3.1.19 ; extra == 'test'
+Requires-Dist: compel (==0.1.8) ; extra == 'test'
+Requires-Dist: GitPython (<3.1.19) ; extra == 'test'
 Requires-Dist: datasets ; extra == 'test'
 Requires-Dist: Jinja2 ; extra == 'test'
-Requires-Dist: invisible-watermark >=0.2.0 ; extra == 'test'
-Requires-Dist: k-diffusion >=0.0.12 ; extra == 'test'
+Requires-Dist: invisible-watermark (>=0.2.0) ; extra == 'test'
+Requires-Dist: k-diffusion (>=0.0.12) ; extra == 'test'
 Requires-Dist: librosa ; extra == 'test'
 Requires-Dist: parameterized ; extra == 'test'
 Requires-Dist: pytest ; extra == 'test'
 Requires-Dist: pytest-timeout ; extra == 'test'
 Requires-Dist: pytest-xdist ; extra == 'test'
-Requires-Dist: requests-mock ==1.10.0 ; extra == 'test'
-Requires-Dist: safetensors >=0.3.1 ; extra == 'test'
-Requires-Dist: sentencepiece !=0.1.92,>=0.1.91 ; extra == 'test'
+Requires-Dist: requests-mock (==1.10.0) ; extra == 'test'
+Requires-Dist: safetensors (>=0.3.1) ; extra == 'test'
+Requires-Dist: sentencepiece (!=0.1.92,>=0.1.91) ; extra == 'test'
 Requires-Dist: scipy ; extra == 'test'
 Requires-Dist: torchvision ; extra == 'test'
-Requires-Dist: transformers >=4.25.1 ; extra == 'test'
+Requires-Dist: transformers (>=4.25.1) ; extra == 'test'
 Provides-Extra: torch
-Requires-Dist: torch >=1.4 ; extra == 'torch'
-Requires-Dist: accelerate >=0.29.3 ; extra == 'torch'
+Requires-Dist: torch (>=1.4) ; extra == 'torch'
+Requires-Dist: accelerate (>=0.29.3) ; extra == 'torch'
 Provides-Extra: training
-Requires-Dist: accelerate >=0.29.3 ; extra == 'training'
+Requires-Dist: accelerate (>=0.29.3) ; extra == 'training'
 Requires-Dist: datasets ; extra == 'training'
-Requires-Dist: protobuf <4,>=3.20.3 ; extra == 'training'
+Requires-Dist: protobuf (<4,>=3.20.3) ; extra == 'training'
 Requires-Dist: tensorboard ; extra == 'training'
 Requires-Dist: Jinja2 ; extra == 'training'
-Requires-Dist: peft >=0.6.0 ; extra == 'training'
+Requires-Dist: peft (>=0.6.0) ; extra == 'training'
 
 <!---
 Copyright 2022 - The HuggingFace Team. All rights reserved.