Add tiny Echo-WM checkpoint for Diffusers tests

.gitattributes

@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+tokenizer/tokenizer.json filter=lfs diff=lfs merge=lfs -text

README.md

@@ -0,0 +1,90 @@
+---
+library_name: diffusers
+tags:
+- modular-diffusers
+- diffusers
+- echo-wm
+- text-to-image
+---
+This is a modular diffusion pipeline built with 🧨 Diffusers' modular pipeline framework.
+
+**Pipeline Type**: EchoWMBlocks
+
+**Description**: 
+
+This pipeline uses a 5-block architecture that can be customized and extended.
+
+## Example Usage
+
+[TODO]
+
+## Pipeline Architecture
+
+This modular pipeline is composed of the following blocks:
+
+1. **text** (`LTX2TextConditioningStep`)
+   - Text-conditioning stage for LTX-2.X: encodes the prompt(s), then runs the text connectors to produce the video/audio-branch connector embeddings the denoiser consumes. Outputs stay at one row per prompt -- the denoise stage expands them by `num_videos_per_prompt` -- so they can be reused across denoise runs.
+2. **camera** (`EchoWMCameraConditionStep`)
+3. **image_encoder** (`EchoWMVaeEncoderStep`)
+   - VAE encoder step that encodes the input `image` into normalized latents for image-to-video generation.
+4. **denoise** (`EchoWMImage2VideoCoreDenoiseStep`)
+   - Denoise block (image-to-video) that expands the text conditioning by `num_videos_per_prompt`, adds image conditioning and runs the joint denoising loop.
+5. **decode** (`EchoWMDecoderStep`) 
+
+## Model Components
+
+1. text_encoder (`PreTrainedModel`)
+2. tokenizer (`PreTrainedTokenizerBase`)
+3. connectors (`LTX2TextConnectors`)
+4. transformer (`EchoWMTransformer3DModel`)
+5. vae (`AutoencoderKLLTX2Video`)
+6. video_processor (`VideoProcessor`)
+7. scheduler (`FlowMatchEulerDiscreteScheduler`)
+8. audio_vae (`AutoencoderKLLTX2Audio`)
+9. guider (`LTX2Guidance`)
+10. audio_guider (`LTX2Guidance`)
+11. vocoder (`LTX2Vocoder`) 
+
+## Input/Output Specification
+
+**Inputs:**
+
+- `prompt` (`str`): The prompt or prompts to guide image generation.
+- `negative_prompt` (`str`, *optional*): The prompt or prompts not to guide the image generation.
+- `max_sequence_length` (`int`, *optional*, defaults to `1024`): Maximum sequence length for prompt encoding.
+- `action` (`str`): WASD/IJKL action program.
+- `height` (`int`, *optional*, defaults to `704`): The height in pixels of the generated image.
+- `width` (`int`, *optional*, defaults to `1280`): The width in pixels of the generated image.
+- `num_frames` (`int`, *optional*, defaults to `241`): Number of output video frames.
+- `frame_rate` (`float`, *optional*, defaults to `24.0`): Output video frame rate.
+- `translation_speed` (`float`, *optional*, defaults to `0.05`): Per-frame camera translation speed for W/A/S/D actions.
+- `rotation_speed_deg` (`float`, *optional*, defaults to `0.5`): Per-frame camera yaw speed in degrees for J/L actions.
+- `pitch_speed_deg` (`float`, *optional*, defaults to `0.2`): Per-frame camera pitch speed in degrees for I/K actions.
+- `pitch_limit_deg` (`float`, *optional*, defaults to `60.0`): Maximum absolute camera pitch in degrees.
+- `fov_deg` (`float`, *optional*, defaults to `70.0`): Horizontal camera field of view in degrees.
+- `num_videos_per_prompt` (`int`, *optional*, defaults to `1`): The number of images to generate per prompt.
+- `image` (`Image | list`): Reference image(s) for denoising. Can be a single image or list of images.
+- `image_crf` (`int`, *optional*): H.264 CRF used to re-compress the conditioning `image` before VAE encode, matching the compression the model was trained against. `None` (default) resolves from the text-encoder generation (33 through LTX-2.3, 18 for LTX-2.5). Pass `0` to skip re-compression. Requires a `PIL.Image.Image` when re-compression runs.
+- `generator` (`Generator`, *optional*): Torch generator for deterministic generation.
+- `num_inference_steps` (`int`, *optional*, defaults to `30`): The number of denoising steps.
+- `timesteps` (`Tensor`, *optional*): Timesteps for the denoising process.
+- `sigmas` (`list`, *optional*): Custom sigmas for the denoising process.
+- `latents` (`Tensor`, *optional*): Pre-generated noisy latents for image generation.
+- `noise_scale` (`float`, *optional*): Interpolation factor between random noise and any provided latents. `None` (default) resolves to 0.0, which keeps the provided latents.
+- `audio_latents` (`Tensor`, *optional*): Optional pre-encoded audio latents; random noise is used when not provided.
+- `**denoiser_input_fields` (`None`, *optional*): conditional model inputs for the denoiser: e.g. prompt_embeds, negative_prompt_embeds, etc.
+- `use_cross_timestep` (`bool`, *optional*, defaults to `True`): Whether to condition the transformer on a separate per-token cross timestep (LTX-2.3+).
+- `attention_kwargs` (`dict`, *optional*): Additional kwargs for attention processors.
+- `output_type` (`str`, *optional*, defaults to `pil`): Output format: 'pil', 'np', 'pt'.
+- `decode_timestep` (`None`, *optional*, defaults to `0.0`): The timestep at which the VAE decodes the final latents.
+- `decode_noise_scale` (`None`, *optional*): Noise interpolation factor applied to the latents at the decode timestep.
+- `vae_tiling` (`bool`, *optional*, defaults to `True`): Enable spatial and temporal VAE decoding tiles to reduce peak memory usage.
+- `vae_tile_size` (`int`, *optional*, defaults to `512`): Spatial tile long-side size in pixels; the short side follows the video aspect ratio.
+- `vae_tile_overlap` (`int`, *optional*, defaults to `64`): Spatial tile overlap in pixels.
+- `vae_temporal_tile_size` (`int`, *optional*, defaults to `64`): Temporal tile size in sample frames, excluding the causal boundary frame.
+- `vae_temporal_tile_overlap` (`int`, *optional*, defaults to `24`): Temporal tile overlap in sample frames.
+
+**Outputs:**
+
+- `videos` (`list`): The generated videos.
+- `audio` (`Tensor`): The generated audio waveform.

audio_vae/config.json

@@ -0,0 +1,24 @@
+{
+  "_class_name": "AutoencoderKLLTX2Audio",
+  "_diffusers_version": "0.41.0.dev0",
+  "_name_or_path": "/tmp/tiny-echo-wm-base-diffusers",
+  "attn_resolutions": null,
+  "base_channels": 4,
+  "causality_axis": "height",
+  "ch_mult": [
+    1
+  ],
+  "double_z": true,
+  "dropout": 0.0,
+  "in_channels": 2,
+  "is_causal": true,
+  "latent_channels": 2,
+  "mel_bins": 8,
+  "mel_hop_length": 160,
+  "mid_block_add_attention": false,
+  "norm_type": "pixel",
+  "num_res_blocks": 1,
+  "output_channels": 2,
+  "resolution": 32,
+  "sample_rate": 16000
+}

audio_vae/diffusion_pytorch_model.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a86c1d8d653163146e3e1c6e5f4365ba23edb41993640b9f4458d39950862610
+size 13416

connectors/config.json

@@ -0,0 +1,26 @@
+{
+  "_class_name": "LTX2TextConnectors",
+  "_diffusers_version": "0.41.0.dev0",
+  "_name_or_path": "/tmp/tiny-echo-wm-base-diffusers",
+  "audio_connector_attention_head_dim": 8,
+  "audio_connector_num_attention_heads": 4,
+  "audio_connector_num_layers": 1,
+  "audio_connector_num_learnable_registers": null,
+  "audio_gated_attn": false,
+  "audio_hidden_dim": 2048,
+  "caption_channels": 32,
+  "causal_temporal_positioning": false,
+  "connector_rope_base_seq_len": 32,
+  "per_modality_projections": false,
+  "proj_bias": false,
+  "rope_double_precision": false,
+  "rope_theta": 10000.0,
+  "rope_type": "split",
+  "text_proj_in_factor": 3,
+  "video_connector_attention_head_dim": 8,
+  "video_connector_num_attention_heads": 4,
+  "video_connector_num_layers": 1,
+  "video_connector_num_learnable_registers": null,
+  "video_gated_attn": false,
+  "video_hidden_dim": 4096
+}

connectors/diffusion_pytorch_model.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:bf8b2f822740f1cc4cbad5462b9679dc7c1ff1a9138080d08ae432d17e51d01d
+size 116776

modular_model_index.json

@@ -0,0 +1,103 @@
+{
+  "_blocks_class_name": "EchoWMBlocks",
+  "_class_name": "EchoWMModularPipeline",
+  "_diffusers_version": "0.41.0.dev0",
+  "audio_vae": [
+    "diffusers",
+    "AutoencoderKLLTX2Audio",
+    {
+      "pretrained_model_name_or_path": "Echo-Team/tiny-echo-wm-base-diffusers",
+      "revision": null,
+      "subfolder": "audio_vae",
+      "type_hint": [
+        "diffusers",
+        "AutoencoderKLLTX2Audio"
+      ],
+      "variant": null
+    }
+  ],
+  "connectors": [
+    "ltx2",
+    "LTX2TextConnectors",
+    {
+      "pretrained_model_name_or_path": "Echo-Team/tiny-echo-wm-base-diffusers",
+      "revision": null,
+      "subfolder": "connectors",
+      "type_hint": [
+        "ltx2",
+        "LTX2TextConnectors"
+      ],
+      "variant": null
+    }
+  ],
+  "text_encoder": [
+    "transformers",
+    "Gemma3ForConditionalGeneration",
+    {
+      "pretrained_model_name_or_path": "Echo-Team/tiny-echo-wm-base-diffusers",
+      "revision": null,
+      "subfolder": "text_encoder",
+      "type_hint": [
+        "transformers",
+        "Gemma3ForConditionalGeneration"
+      ],
+      "variant": null
+    }
+  ],
+  "tokenizer": [
+    "transformers",
+    "GemmaTokenizer",
+    {
+      "pretrained_model_name_or_path": "Echo-Team/tiny-echo-wm-base-diffusers",
+      "revision": null,
+      "subfolder": "tokenizer",
+      "type_hint": [
+        "transformers",
+        "GemmaTokenizer"
+      ],
+      "variant": null
+    }
+  ],
+  "transformer": [
+    "diffusers",
+    "EchoWMTransformer3DModel",
+    {
+      "pretrained_model_name_or_path": "Echo-Team/tiny-echo-wm-base-diffusers",
+      "revision": null,
+      "subfolder": "transformer",
+      "type_hint": [
+        "diffusers",
+        "EchoWMTransformer3DModel"
+      ],
+      "variant": null
+    }
+  ],
+  "vae": [
+    "diffusers",
+    "AutoencoderKLLTX2Video",
+    {
+      "pretrained_model_name_or_path": "Echo-Team/tiny-echo-wm-base-diffusers",
+      "revision": null,
+      "subfolder": "vae",
+      "type_hint": [
+        "diffusers",
+        "AutoencoderKLLTX2Video"
+      ],
+      "variant": null
+    }
+  ],
+  "vocoder": [
+    "ltx2",
+    "LTX2Vocoder",
+    {
+      "pretrained_model_name_or_path": "Echo-Team/tiny-echo-wm-base-diffusers",
+      "revision": null,
+      "subfolder": "vocoder",
+      "type_hint": [
+        "ltx2",
+        "LTX2Vocoder"
+      ],
+      "variant": null
+    }
+  ]
+}

text_encoder/config.json

@@ -0,0 +1,78 @@
+{
+  "architectures": [
+    "Gemma3ForConditionalGeneration"
+  ],
+  "boi_token_index": 255999,
+  "dtype": "float32",
+  "eoi_token_index": 256000,
+  "eos_token_id": [
+    1,
+    106
+  ],
+  "image_token_index": 262144,
+  "initializer_range": 0.02,
+  "mm_tokens_per_image": 256,
+  "model_type": "gemma3",
+  "text_config": {
+    "_sliding_window_pattern": 2,
+    "attention_bias": false,
+    "attention_dropout": 0.0,
+    "attn_logit_softcapping": null,
+    "bos_token_id": 2,
+    "cache_implementation": "hybrid",
+    "dtype": "float32",
+    "eos_token_id": 1,
+    "final_logit_softcapping": null,
+    "head_dim": 32,
+    "hidden_activation": "gelu_pytorch_tanh",
+    "hidden_size": 32,
+    "initializer_range": 0.02,
+    "intermediate_size": 128,
+    "layer_types": [
+      "sliding_attention",
+      "full_attention"
+    ],
+    "max_position_embeddings": 131072,
+    "model_type": "gemma3_text",
+    "num_attention_heads": 1,
+    "num_hidden_layers": 2,
+    "num_key_value_heads": 1,
+    "pad_token_id": 0,
+    "query_pre_attn_scalar": 168,
+    "rms_norm_eps": 1e-06,
+    "rope_parameters": {
+      "full_attention": {
+        "factor": 8.0,
+        "rope_theta": 1000000.0,
+        "rope_type": "linear"
+      },
+      "sliding_attention": {
+        "rope_theta": 10000.0,
+        "rope_type": "default"
+      }
+    },
+    "sliding_window": 1024,
+    "sliding_window_pattern": 2,
+    "tie_word_embeddings": true,
+    "use_bidirectional_attention": false,
+    "use_cache": true,
+    "vocab_size": 262208
+  },
+  "tie_word_embeddings": true,
+  "transformers_version": "5.16.1",
+  "vision_config": {
+    "attention_dropout": 0.0,
+    "dtype": "float32",
+    "hidden_act": "gelu_pytorch_tanh",
+    "hidden_size": 32,
+    "image_size": 896,
+    "intermediate_size": 128,
+    "layer_norm_eps": 1e-06,
+    "model_type": "siglip_vision_model",
+    "num_attention_heads": 1,
+    "num_channels": 3,
+    "num_hidden_layers": 2,
+    "patch_size": 14,
+    "vision_use_head": false
+  }
+}

text_encoder/generation_config.json

@@ -0,0 +1,11 @@
+{
+  "_from_model_config": true,
+  "bos_token_id": 2,
+  "cache_implementation": "hybrid",
+  "eos_token_id": [
+    1,
+    106
+  ],
+  "pad_token_id": 0,
+  "transformers_version": "5.16.1"
+}

text_encoder/model.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:2f2b2e38ee7aced4b332a26484feae78e3d809c0cec32b1bb2a50e62962d0614
+size 34409608

tokenizer/chat_template.jinja

@@ -0,0 +1,47 @@
+{{ bos_token }}
+{%- if messages[0]['role'] == 'system' -%}
+    {%- if messages[0]['content'] is string -%}
+        {%- set first_user_prefix = messages[0]['content'] + '
+
+' -%}
+    {%- else -%}
+        {%- set first_user_prefix = messages[0]['content'][0]['text'] + '
+
+' -%}
+    {%- endif -%}
+    {%- set loop_messages = messages[1:] -%}
+{%- else -%}
+    {%- set first_user_prefix = "" -%}
+    {%- set loop_messages = messages -%}
+{%- endif -%}
+{%- for message in loop_messages -%}
+    {%- if (message['role'] == 'user') != (loop.index0 % 2 == 0) -%}
+        {{ raise_exception("Conversation roles must alternate user/assistant/user/assistant/...") }}
+    {%- endif -%}
+    {%- if (message['role'] == 'assistant') -%}
+        {%- set role = "model" -%}
+    {%- else -%}
+        {%- set role = message['role'] -%}
+    {%- endif -%}
+    {{ '<start_of_turn>' + role + '
+' + (first_user_prefix if loop.first else "") }}
+    {%- if message['content'] is string -%}
+        {{ message['content'] | trim }}
+    {%- elif message['content'] is iterable -%}
+        {%- for item in message['content'] -%}
+            {%- if item['type'] == 'image' -%}
+                {{ '<start_of_image>' }}
+            {%- elif item['type'] == 'text' -%}
+                {{ item['text'] | trim }}
+            {%- endif -%}
+        {%- endfor -%}
+    {%- else -%}
+        {{ raise_exception("Invalid content type") }}
+    {%- endif -%}
+    {{ '<end_of_turn>
+' }}
+{%- endfor -%}
+{%- if add_generation_prompt -%}
+    {{'<start_of_turn>model
+'}}
+{%- endif -%}

tokenizer/tokenizer.json

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:daab2354f8a74e70d70b4d1f804939b68a8c9624dd06cb7858e52dd8970e9726
+size 33384567

tokenizer/tokenizer_config.json

@@ -0,0 +1,26 @@
+{
+  "backend": "tokenizers",
+  "boi_token": "<start_of_image>",
+  "bos_token": "<bos>",
+  "clean_up_tokenization_spaces": false,
+  "eoi_token": "<end_of_image>",
+  "eos_token": "<eos>",
+  "image_token": "<image_soft_token>",
+  "is_local": true,
+  "local_files_only": false,
+  "mask_token": "<mask>",
+  "model_max_length": 1000000000000000019884624838656,
+  "model_specific_special_tokens": {
+    "boi_token": "<start_of_image>",
+    "eoi_token": "<end_of_image>",
+    "image_token": "<image_soft_token>"
+  },
+  "pad_token": "<pad>",
+  "processor_class": "Gemma3Processor",
+  "sp_model_kwargs": null,
+  "spaces_between_special_tokens": false,
+  "tokenizer_class": "GemmaTokenizer",
+  "unk_token": "<unk>",
+  "use_default_system_prompt": false,
+  "variant": null
+}

transformer/config.json

@@ -0,0 +1,67 @@
+{
+  "_class_name": "EchoWMTransformer3DModel",
+  "_diffusers_version": "0.41.0.dev0",
+  "_name_or_path": "/tmp/tiny-echo-wm-base-diffusers",
+  "activation_fn": "gelu-approximate",
+  "attention_bias": true,
+  "attention_head_dim": 8,
+  "attention_out_bias": true,
+  "audio_attention_head_dim": 4,
+  "audio_cross_attention_dim": 8,
+  "audio_cross_attn_mod": false,
+  "audio_ff_bias": true,
+  "audio_gated_attn": false,
+  "audio_hop_length": 160,
+  "audio_in_channels": 4,
+  "audio_num_attention_heads": 2,
+  "audio_out_channels": 4,
+  "audio_patch_size": 1,
+  "audio_patch_size_t": 1,
+  "audio_pos_embed_max_pos": 20,
+  "audio_sampling_rate": 16000,
+  "audio_scale_factor": 4,
+  "base_height": 2048,
+  "base_width": 2048,
+  "caption_channels": 32,
+  "causal_offset": 1,
+  "cross_attention_dim": 16,
+  "cross_attn_mod": false,
+  "cross_attn_timestep_scale_multiplier": 1000,
+  "ff_bias": true,
+  "gated_attn": false,
+  "in_channels": 4,
+  "norm_elementwise_affine": false,
+  "norm_eps": 1e-06,
+  "num_attention_heads": 2,
+  "num_layers": 2,
+  "out_channels": 4,
+  "patch_size": 1,
+  "patch_size_t": 1,
+  "perturbed_attn": false,
+  "pos_embed_max_pos": 20,
+  "qk_norm": "rms_norm_across_heads",
+  "rope_double_precision": false,
+  "rope_theta": 10000.0,
+  "rope_type": "split",
+  "timestep_scale_multiplier": 1000,
+  "ucpe_attention_dim": 16,
+  "ucpe_block_indices": [
+    0,
+    1
+  ],
+  "ucpe_freq_base": 100.0,
+  "ucpe_freq_scale": 1.0,
+  "ucpe_image_height": 32,
+  "ucpe_image_width": 32,
+  "ucpe_num_attention_heads": 2,
+  "ucpe_patches_x": 16,
+  "ucpe_patches_y": 16,
+  "use_keyframes_abs_pos_embedding": false,
+  "use_prompt_adaln_single": true,
+  "use_prompt_embeddings": true,
+  "vae_scale_factors": [
+    8,
+    32,
+    32
+  ]
+}

transformer/diffusion_pytorch_model.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:29ba3051f4bd3f28d856a4176456fe1a0756400f7ddc092369195376d23b5484
+size 182912

vae/config.json

@@ -0,0 +1,62 @@
+{
+  "_class_name": "AutoencoderKLLTX2Video",
+  "_diffusers_version": "0.41.0.dev0",
+  "_name_or_path": "/tmp/tiny-echo-wm-base-diffusers",
+  "block_out_channels": [
+    8
+  ],
+  "decoder_block_out_channels": [
+    8
+  ],
+  "decoder_causal": false,
+  "decoder_inject_noise": [
+    false,
+    false
+  ],
+  "decoder_layers_per_block": [
+    1,
+    1
+  ],
+  "decoder_spatial_padding_mode": "reflect",
+  "decoder_spatio_temporal_scaling": [
+    true
+  ],
+  "down_block_types": [
+    "LTX2VideoDownBlock3D",
+    "LTX2VideoDownBlock3D",
+    "LTX2VideoDownBlock3D",
+    "LTX2VideoDownBlock3D"
+  ],
+  "downsample_type": [
+    "spatial"
+  ],
+  "encoder_causal": true,
+  "encoder_spatial_padding_mode": "zeros",
+  "in_channels": 3,
+  "latent_channels": 4,
+  "layers_per_block": [
+    1
+  ],
+  "out_channels": 3,
+  "patch_size": 1,
+  "patch_size_t": 1,
+  "resnet_norm_eps": 1e-06,
+  "scaling_factor": 1.0,
+  "spatial_compression_ratio": null,
+  "spatio_temporal_scaling": [
+    true
+  ],
+  "temporal_compression_ratio": null,
+  "timestep_conditioning": false,
+  "upsample_factor": [
+    1
+  ],
+  "upsample_residual": [
+    false
+  ],
+  "upsample_type": [
+    "spatiotemporal",
+    "spatiotemporal",
+    "spatiotemporal"
+  ]
+}

vae/diffusion_pytorch_model.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:056241bb4b8a029713f5f71bbe3c5f904cdea378fab80ecbb2a8e7e9035140c8
+size 116464

vocoder/config.json

@@ -0,0 +1,34 @@
+{
+  "_class_name": "LTX2Vocoder",
+  "_diffusers_version": "0.41.0.dev0",
+  "_name_or_path": "/tmp/tiny-echo-wm-base-diffusers",
+  "act_fn": "leaky_relu",
+  "antialias": false,
+  "antialias_kernel_size": 12,
+  "antialias_ratio": 2,
+  "final_act_fn": "tanh",
+  "final_bias": true,
+  "hidden_channels": 32,
+  "in_channels": 16,
+  "leaky_relu_negative_slope": 0.1,
+  "out_channels": 2,
+  "output_sampling_rate": 16000,
+  "resnet_dilations": [
+    [
+      1,
+      3,
+      5
+    ]
+  ],
+  "resnet_kernel_sizes": [
+    3
+  ],
+  "upsample_factors": [
+    2,
+    2
+  ],
+  "upsample_kernel_sizes": [
+    4,
+    4
+  ]
+}

vocoder/diffusion_pytorch_model.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:be58882aaf71ba653bb607eb160f025c3526a85b589770836a1169b513cfbb94
+size 51616