Add a Diffusers usage section (Modular Diffusers custom blocks) (#2)

- Add a Diffusers usage section (Modular Diffusers custom blocks) (256530935bb88f1fb5f40b059de06b8c7e6acc69)


Co-authored-by: Apolinário from multimodal AI art <multimodalart@users.noreply.huggingface.co>

README.md

@@ -252,6 +252,68 @@ language you request. `target_aspect_ratio` is a positive-integer `W:H` string.
 If you select an explicit ratio, the model preserves it exactly. If you select
 `adaptive`, the model determines a numeric ratio for the intended edited image.
 
+## Use with Diffusers
+
+MiniMax-H3-Image-PE can also run locally in Transformers through the
+[`diffusers/minimax-h3-image-pe-blocks`](https://huggingface.co/diffusers/minimax-h3-image-pe-blocks)
+Modular Diffusers blocks. The blocks use the released prompts and request
+parameters for T2I PE and Image editing PE, and XGrammar constrains the answer
+to the JSON schema.
+
+### Load MiniMax-H3-Image-PE
+
+```bash
+pip install -U diffusers transformers xgrammar bitsandbytes kernels flash-linear-attention
+```
+
+```python
+import torch
+from diffusers import ModularPipeline
+
+pe = ModularPipeline.from_pretrained("diffusers/minimax-h3-image-pe-blocks", trust_remote_code=True)
+pe.load_components(dtype=torch.bfloat16, device_map="cuda")
+```
+
+The FP4 weights stay in 4-bit and use about 19 GiB of GPU memory. GPUs with
+native FP4 support run the NVFP4 weights directly; other GPUs use bitsandbytes
+FP4.
+
+### Expand a prompt
+
+Pass a request to run T2I PE:
+
+```python
+state = pe(prompt="An orange tabby cat sleeping on a sunlit windowsill.")
+print(state.get("prompt"), state.get("aspect_ratio"))
+```
+
+Pass reference images to run Image editing PE. Refer to the images in their
+supplied order:
+
+```python
+state = pe(
+    prompt="Replace the bag in the first image with the bag in the second image.",
+    image=["source.png", "bag.png"],
+    aspect_ratio="adaptive",
+)
+print(state.get("prompt"), state.get("aspect_ratio"))
+```
+
+### Inputs and outputs
+
+| Name | Description |
+| --- | --- |
+| `prompt` | Input: the request or editing instruction. Output: the expanded caption. |
+| `image` | One or more reference images (PIL images, paths or URLs). Selects Image editing PE. |
+| `aspect_ratio` | Input, Image editing PE only: `adaptive` or an explicit `W:H` ratio. Output: the target ratio. |
+| `enable_thinking` | Reasoning before the answer, `True` by default as in the released request. |
+| `max_new_tokens` | Token budget, including thinking and the final answer. |
+| `seed` | Seed for a reproducible expansion. |
+| `reasoning` | Output: the model's reasoning. |
+
+Activations run in bf16, so outputs are not identical to the SGLang deployment
+above.
+
 ## License
 
 - MiniMax-H3-Image-PE is part of MiniMax-H3-Image and is released under the [MiniMax-H3-Image Community License Agreement](https://huggingface.co/MiniMaxAI/MiniMax-H3-Image/blob/main/LICENSE).