Add model card

Model card with quickstart, recommended resolutions, prompting and editing guidance, and figures.

.gitattributes

@@ -37,3 +37,9 @@ text_encoder/tokenizer.json filter=lfs diff=lfs merge=lfs -text
 processor/tokenizer.json filter=lfs diff=lfs merge=lfs -text
 tokenizer/tokenizer.json filter=lfs diff=lfs merge=lfs -text
 prompt_upsampler_processor/tokenizer.json filter=lfs diff=lfs merge=lfs -text
+assets/edits.jpg filter=lfs diff=lfs merge=lfs -text
+assets/multi_image.jpg filter=lfs diff=lfs merge=lfs -text
+assets/p-h3-image.jpg filter=lfs diff=lfs merge=lfs -text
+assets/prompt.jpg filter=lfs diff=lfs merge=lfs -text
+assets/resolution_ladder.jpg filter=lfs diff=lfs merge=lfs -text
+assets/styles.jpg filter=lfs diff=lfs merge=lfs -text

README.md

@@ -13,8 +13,326 @@ tags:
 - image-to-image
 - image-generation
 - image-editing
+- prompt-upsampling
 - minimax-h3
 - diffusers
 - modular-diffusers
 - pruna-ai
 ---
+<!-- header start -->
+<p align="center">
+  <img src="assets/p-h3-image.jpg" width="800">
+</p>
+<!-- header end -->
+
+<p align="center">
+  <a href="https://github.com/PrunaAI/pruna">
+    <img src="https://img.shields.io/badge/GitHub-PrunaAI-9334E9?style=plastic&logo=github&logoColor=white" alt="GitHub">
+  </a>
+  &nbsp;
+  <a href="https://twitter.com/PrunaAI">
+    <img src="https://img.shields.io/badge/Twitter%2FX-@PrunaAI-9334E9?style=plastic&logo=x&logoColor=white" alt="Twitter/X">
+  </a>
+  &nbsp;
+  <a href="https://www.linkedin.com/company/pruna-ai">
+    <img src="https://img.shields.io/badge/LinkedIn-PrunaAI-9334E9?style=plastic&logo=linkedin&logoColor=white" alt="LinkedIn">
+  </a>
+  &nbsp;
+  <a href="https://discord.com/invite/JFQmtFKCjd">
+    <img src="https://img.shields.io/badge/Discord-Join%20us-9334E9?style=plastic&logo=discord&logoColor=white" alt="Discord">
+  </a>
+  &nbsp;
+  <a href="https://dashboard.pruna.ai/login?utm_source=huggingface&utm_medium=org_card&utm_campaign=hf_traffic">
+    <img src="https://img.shields.io/badge/Performance%20Models-Try%20them%20now-9334E9?style=plastic&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI0MTEiIGhlaWdodD0iNDc3IiBmaWxsPSJub25lIj48cGF0aCBmaWxsPSIjZmZmIiBkPSJNMjMuNzAzIDMwMC41MzJjLTEuODQyLS42NzQtNC4xNDItMS4wNTctNS43MDMtMi4wMjktMTIuNTU4LTcuODQ2LTguODM3LTI1LjE3MiA1LjI1NS0yOC4zNjFhLjY2LjY2IDAgMCAwIC4zNDgtLjIwMS42LjYgMCAwIDAgLjE1Ni0uMzZxNi40OS04MS45ODYgNjguNTc3LTEzNC42MjlhLjM0LjM0IDAgMCAwIC4wOTItLjEyNS4zMy4zMyAwIDAgMC0uMDI2LS4zLjMzLjMzIDAgMCAwLS4xMTItLjEwOGMtNC4xMTUtMi40OTctOC42NC00Ljc1LTEyLjM1My03LjQ0M2ExOTAgMTkwIDAgMCAxLTE4Ljc5NC0xNS41MjJjLTIuOTM2LTIuNzY4LTMuNzAzLTUuODkxLjU4LTcuNzdhLjUuNSAwIDAgMCAuMjgtLjYwOEM1MyA3NS45NSA0OC40MTcgNDguNTk5IDQ1LjUxOCAxOS42NXEtLjM5My0zLjg1Mi0uMjcxLTYuMzJhLjc1Ljc1IDAgMCAxIC4xMzQtLjQuNy43IDAgMCAxIC4zMjQtLjI1NXEyLjEwNC0uODQyIDUuODQ0LTEuNDMxYzU4LjExNC05LjEzNiAxMjcuMDA5IDguNDI1IDE0NC4zMDcgNzIuNjQ1cS4xMDMuMzY0LjE3OCAwIDUuMDk2LTI0LjA5NyA0LjYzOC00OC4xOTMtLjA0Ny0yLjc4NyAxLjg3OS00Ljc4OCAxMC40MDctMTAuOCAyNC43OTgtOC42ODdjNy40NzEgMS4wOTUgNy43NDIgNC42MzggNy4yMDkgMTEuMWEzMzQgMzM0IDAgMCAxLTExLjg4NCA2NC43MDYuMzg4LjM4OCAwIDAgMCAuMTgyLjQ0NC40LjQgMCAwIDAgLjE2NC4wNTFjOTIuNDIxIDguNDUzIDE1OC44NzUgNzkuNDg5IDE2NS4wODQgMTcxLjI3NGExIDEgMCAwIDAgLjEyOS40MjQuODMuODMgMCAwIDAgLjI5MS4yOTZjMy43NSAyLjE3IDYuMiAyLjIxNiA4Ljg1NSA2LjU5MiA1LjA2OCA4LjMzMiAxLjQ1IDIwLjQzMS04LjU5MyAyMi40N2ExLjcxIDEuNzEgMCAwIDAtMS4zNjUgMS40NjhxLTkuMTczIDc1LjM4My02NC43NjIgMTIzLjM3MWMtMjguNjIyIDI0LjcwNC02NS43NDQgMzkuNzQ5LTEwMy40NjQgNDIuMzMtMTAwLjM1OSA2Ljg2My0xODQuNDg2LTY1LjYyMi0xOTUuMDA1LTE2NS41N2EuOC44IDAgMCAwLS4xNTQtLjM5NS43NC43NCAwIDAgMC0uMzMzLS4yNU0xNTEuMzM4IDk3LjY0M2wxOS4wNjYgMTkuMzc1YS41LjUgMCAwIDAgLjE1LjEuNS41IDAgMCAwIC4xNzYuMDMxLjQzLjQzIDAgMCAwIC4zMTktLjE1cTEwLjg0Ny0xMi40NjUgNy40NDMtMjguMTU1Yy00LjUzNS0yMC44Ni0xOC41OTgtMzcuNjY0LTM3LjI3MS00OC4zODktMjEuMDY3LTEyLjY4OS00Ny44NjUtMTUuOTA1LTcyLjI4LTE0Ljg0cS0uNjE3LjAzLS4xNC40MjJsNjMuNDcyIDUzLjMyNmEuNC40IDAgMCAwIC4xNDQuMDcyLjM0LjM0IDAgMCAwIC4zMDEtLjA2OC4zLjMgMCAwIDAgLjA4OC0uMTI2IDQ3IDQ3IDAgMCAwIDMuMjgyLTEzLjA4MXEuMDIzLS4yMzMuMTI0LS40MzN0LjI2OC0uMzM0YzIuOTU1LTIuNDc4IDQuMTE1LjQ1OCA0LjY5NCAyLjg1MnEyLjMyIDkuNTM3LjE4NyAxOS4yNDRhMS40OCAxLjQ4IDAgMCAwIC40NCAxLjQwM3ptLTYuNTI2IDkuMjk1LTkuMDI0LTEwLjI3NmEuNy43IDAgMCAwLS4zNDMtLjIwNy44Ni44NiAwIDAgMC0uNDMzIDBxLTExLjY4IDMuMDIxLTIzLjExNC0uODIyYy01LjgxNi0zLjg1Mi0uNzU4LTUuNTE3IDIuNTktNS44MTZxNS45MTgtLjUzMyAxMS43MzUtMi41MDZhLjMuMyAwIDAgMCAuMTI3LS4wOC4zLjMgMCAwIDAgLjA3My0uMTMzLjM0LjM0IDAgMCAwIC4wMDEtLjE1NC4zNC4zNCAwIDAgMC0uMDctLjEzOGMtMTkuNDU5LTIxLjE1LTQwLjc2LTQwLjI0NS02Mi4yNzUtNTkuMjY0cS0uMzU2LS4zMTgtLjMxOC4xNWEzMDggMzA4IDAgMCAwIDguMzg3IDUxLjgwMmM0LjU5MiAxOC4zMDggMTMuNzU1IDM0LjE1NyAzMS44NDggNDEuODcycTI2LjI0NyAxMS4xODIgNTMuNzI5IDIuODMzYS41ODMuNTgzIDAgMCAwIC4yOTktLjg4OCAyMzUgMjM1IDAgMCAwLTEzLjIxMi0xNi4zNzNtNDUuMTI1IDQ5Ljc0NXEtMTIuNTk1IDEuMzE4LTIzLjQ0MS01LjU4M2MtMy4wNzctNC44OTkgMi4wNjYtOC41OTMgNS40NDItMTEuMTgzYS41ODQuNTg0IDAgMCAwIC4xODctLjcwMSA4LjQ2IDguNDYgMCAwIDAtMy40ODgtMy44NjIuODEuODEgMCAwIDAtLjgyMy4wMDljLTE2LjY5MSA5Ljk3Ny0zNC40ODUgMTAuNzgyLTUzLjE4NiA2Ljk2N3EtMS41Ny0uMzItMi44NTIuNjQ1LTYxLjQ1MSA0Ni4zNy02OS42NyAxMjMuOTEzLS42ODMgNi40MzMtMS44MDYgOC44MjdjLTIuOTQ1IDYuMzAyLTcuNzcgNy44NDUtMTQuMjIyIDkuNDcycS0uNDQ5LjExMyAwIC4yMzRjOS4yNzYgMi4zMSAxNC42OCA2LjE0MyAxNi4wNzQgMTYuNDAxIDguNDYyIDYyLjQ5IDQ4Ljk0IDExNy44NjQgMTEwLjM4MyAxMzguMzQxYTEwNCAxMDQgMCAwIDAgMTEuMDA2IDMuNTA3YzkyLjY0NSAyMy45MDkgMTgxLjIzMi0zMy42NjIgMjAyLjgwNC0xMjUuMDU0cTEuNjA5LTYuNzkgMy40NS0xOS4wODVjMS4xMDQtNy4zOTYgNS42OTUtMTIuMTE4IDEzLjE0Ny0xMy41NjguNDEyLS4wODQgMS45MDgtLjc1Ny4yODEtLjk5MS04LjA1MS0xLjE0MS0xMi4yNC02LjM4Ni0xMi45ODgtMTQuMTI4cS0xLjA3NS0xMS4yNS0yLjUxNi0xOS4wMzhjLTExLjc3Mi02My44OTItNTYuMzgzLTExNC41NzItMTE5LjI4NS0xMzEuNDZxLTE1LjEyLTMuODgtMzAuOTg3LTUuMjQ1YS4zODYuMzg2IDAgMCAwLS40MDIuMjUyIDE2OC42IDE2OC42IDAgMCAxLTExLjM1MiAyNC44NTRjLTQuMTMzIDcuNDA2LTguMTYzIDE1LjQ5NC0xNS43NTYgMTYuNDc2Ii8+PGNpcmNsZSBjeD0iMTQwLjA2NSIgY3k9IjI3My4wMyIgcj0iNTAuNjE4IiBzdHJva2U9IiNmZmYiIHN0cm9rZS13aWR0aD0iOS4yMDMiLz48cGF0aCBmaWxsPSIjZmZmIiBkPSJNMTQ2Ljk2NyAyNDIuMDkyYzE1LjY3MiAwIDI4LjM3NiAxMy45NjMgMjguMzc2IDMxLjE4OHMtMTIuNzA0IDMxLjE4OS0yOC4zNzYgMzEuMTg5LTI4LjM3Ny0xMy45NjQtMjguMzc3LTMxLjE4OWMwLTIuNjI1LjI5Ny01LjE3NC44NTItNy42MSAxLjYwNyAzLjcyNyA1LjMxMyA2LjMzOCA5LjYyOSA2LjMzOCA1Ljc4OSAwIDEwLjQ4MS00LjY5MyAxMC40ODItMTAuNDgycy00LjY5My0xMC40ODEtMTAuNDgyLTEwLjQ4MWMtLjc2MSAwLTEuNTA0LjA4My0yLjIxOS4yMzcgNS4xMzktNS42NzYgMTIuMjUzLTkuMTkgMjAuMTE1LTkuMTkiLz48Y2lyY2xlIGN4PSIyNjkuOTMyIiBjeT0iMjczLjAzIiByPSI1MC42MTgiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSI5LjIwMyIvPjxwYXRoIGZpbGw9IiNmZmYiIGQ9Ik0yNzYuODM0IDI0Mi4wOTJjMTUuNjcyIDAgMjguMzc2IDEzLjk2MyAyOC4zNzYgMzEuMTg4cy0xMi43MDQgMzEuMTg5LTI4LjM3NiAzMS4xODktMjguMzc3LTEzLjk2NC0yOC4zNzctMzEuMTg5YzAtMi42MjUuMjk3LTUuMTc0Ljg1My03LjYxIDEuNjA2IDMuNzI3IDUuMzEyIDYuMzM4IDkuNjI4IDYuMzM4IDUuNzg5IDAgMTAuNDgyLTQuNjkzIDEwLjQ4Mi0xMC40ODJzLTQuNjkzLTEwLjQ4MS0xMC40ODItMTAuNDgxYy0uNzYxIDAtMS41MDQuMDgzLTIuMjE5LjIzNyA1LjEzOS01LjY3NiAxMi4yNTQtOS4xOSAyMC4xMTUtOS4xOSIvPjxwYXRoIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSI5LjIwMyIgZD0iTTE3Ny4xMzUgMzQ1LjMyOGMuODk5LS4yNCAyLjgwMS0uMTk3IDYuMzA0LjQ2NCA2LjMxMSAxLjE5IDE2LjU4NSA0LjIyMSAyNi4xMjIgNC4yMjEgOS40NTIgMCAxNy4xMTgtMS45MjYgMjEuMzgzLTIuNjAzLjc3LS4xMjMgMS4zODUtLjE5OSAxLjg3OC0uMjM3LS4zNCAxMy44NDMtMTIuODkzIDI3LjcxLTI3Ljg2OCAyNy43MS0xNS4xNzIgMC0yNy44NzYtMTMuODM1LTI3Ljg3Ni0yOC44MTEgMC0uMzU3LjAyOS0uNTk2LjA1Ny0uNzQ0WiIvPjwvc3ZnPg==" alt="Performance Models">
+  </a>
+</p>
+<div align="center">
+
+<h1 style="color: #9334E9;">p-h3-image</h1>
+
+<h2>Image generation and editing based on MiniMax-H3</h2>
+
+<h3>
+  <span style="color: #9334E9;">8 steps</span>
+  &nbsp;·&nbsp;
+  <span style="color: #9334E9;">No CFG</span>
+  &nbsp;·&nbsp;
+  <span style="color: #9334E9;">8 MP</span>
+  &nbsp;·&nbsp;
+  Text-to-image and editing with up to 8 images
+</h3>
+
+</div>
+
+**p-h3-image** is an image model for text-to-image generation and image editing, based on
+[MiniMax-H3](https://huggingface.co/MiniMaxAI/MiniMax-H3). It renders 8-megapixel images in 8 steps without
+classifier-free guidance, edits with up to 8 input images, and comes with a prompt upsampler that turns a one-line
+request into the full prompt p-h3-image renders best. It is strongest at photorealism, film and editorial looks, and
+graphic styles with short quoted text.
+
+This repository holds the [diffusers](https://github.com/huggingface/diffusers) pipeline. For ComfyUI, with int8 and
+4-bit files that run in 21 GB of VRAM, see [PrunaAI/p-h3-image-comfy](https://huggingface.co/PrunaAI/p-h3-image-comfy).
+
+| | |
+|---|---|
+| **Tasks** | Text-to-image, and image editing with 1 to 8 input images |
+| **Sampling** | 8 steps, no CFG or negative prompt |
+| **Resolution** | 8 MP for text-to-image, 4 or 8 MP for edits |
+| **Prompt upsampler** | Included and on by default, based on Qwen3.5-9B |
+| **Weights** | 33.1B-parameter transformer, 4B text encoder, VAE and prompt upsampler, 100 GB in bf16 |
+| **GPU memory at 8 MP** | About 101 GB with the prompt upsampler, 83 GB without |
+
+## Quickstart
+
+Runs text-to-image and editing with the same pipeline. At 8 MP in bf16 it needs a GPU with about 101 GB of memory,
+such as one H200 or B200.
+
+```bash
+pip install -U diffusers transformers accelerate torch pillow
+```
+
+```python
+import torch
+from diffusers import ModularPipeline
+
+pipe = ModularPipeline.from_pretrained("PrunaAI/p-h3-image")
+pipe.load_components(dtype=torch.bfloat16)
+pipe.to("cuda")
+
+prompt = (
+    "A German Expressionist oil painting of a Berlin street at night in the manner of Ernst Ludwig Kirchner, "
+    "with gaunt figures hurrying past a glowing gas lamp."
+)
+image = pipe(
+    prompt=prompt,
+    height=3360, width=2496,  # 8 MP, 3:4
+    generator=torch.Generator().manual_seed(3),
+    output="images",
+)[0]
+image.save("berlin.png")
+```
+
+The pipeline picks the task from its inputs. Pass `image` to edit.
+
+```python
+from diffusers.utils import load_image
+
+# Edit one image
+edited = pipe(prompt="let it snow on the street", image=image, output="images")[0]
+
+# Up to 8 images. The first is edited, the others are references, named Picture 2, Picture 3 and so on.
+composed = pipe(
+    prompt="give the woman in picture 1 the hat from picture 2",
+    image=[load_image("portrait.png"), load_image("hat.png")],
+    output="images",
+)[0]
+```
+
+## Recommended resolutions
+
+<p align="center">
+  <img src="assets/resolutions.png" width="100%">
+</p>
+
+p-h3-image works best at **8 MP**. Images at 2 and 4 MP can be good too, but artifacts become more frequent, especially
+in faces, hands and small details. For text-to-image, use one of the 8 MP sizes below. The default is 2912 × 2912.
+
+Edits work best at 4 or 8 MP. Without `height` and `width`, the edit is generated at the size of Picture 1, scaled up to
+at least 4 MP. The other images keep their size between 1 and 8 MP. Passing `height` and `width` changes the canvas,
+not the images. Sides are rounded to multiples of 32, with a warning.
+
+| Aspect ratio | 8 MP (width × height) | 4 MP, for edits |
+|:---:|:---:|:---:|
+| 1:1 | **2912 × 2912** | 2048 × 2048 |
+| 4:3 | **3360 × 2496** | 2368 × 1760 |
+| 3:4 | **2496 × 3360** | 1760 × 2368 |
+| 3:2 | **3552 × 2368** | 2496 × 1664 |
+| 2:3 | **2368 × 3552** | 1664 × 2496 |
+| 16:9 | **3872 × 2176** | 2720 × 1536 |
+| 9:16 | **2176 × 3872** | 1536 × 2720 |
+
+```python
+SIZES_8MP = {  # aspect ratio -> (width, height)
+    "1:1": (2912, 2912),
+    "4:3": (3360, 2496),
+    "3:4": (2496, 3360),
+    "3:2": (3552, 2368),
+    "2:3": (2368, 3552),
+    "16:9": (3872, 2176),
+    "9:16": (2176, 3872),
+}
+
+width, height = SIZES_8MP["16:9"]
+image = pipe(prompt=prompt, width=width, height=height, output="images")[0]
+```
+
+<p align="center">
+  <img src="assets/resolution_ladder.jpg" width="100%">
+</p>
+
+*The same prompt and seed from 1 to 16 MP, with the face enlarged in the bottom row. At 1 MP the face is smooth and
+waxy. From 8 MP on, skin texture, stray hairs and the gold earrings come through. The composition shifts between
+resolutions because the noise changes with the image size.*
+
+## Prompting
+
+p-h3-image is sensitive to prompting and renders full, specific prompts much better than short requests. The pipeline
+therefore runs a prompt upsampler, based on Qwen3.5-9B, on every request. It writes a detailed prompt for the aspect
+ratio of `height` and `width`, or, for an edit, a brief of what to keep and what to change. The prompt it wrote comes
+back as the `prompt` output.
+
+```python
+out = pipe(prompt=prompt, height=3360, width=2496, output=["images", "prompt"])
+print(out["prompt"])
+```
+
+To render a prompt as written, remove the step from the blocks.
+
+```python
+blocks = ModularPipeline.from_pretrained("PrunaAI/p-h3-image").blocks
+blocks.sub_blocks.pop("prompt_upsampler")
+
+pipe = blocks.init_pipeline("PrunaAI/p-h3-image")
+pipe.load_components(dtype=torch.bfloat16)
+pipe.to("cuda")
+image = pipe(prompt=prompt, height=3360, width=2496, output="images")[0]  # rendered as written
+```
+
+When you write prompts by hand, four things matter most.
+
+1. **Say what the image is.** Open with one sentence that names the real object the image is, such as "a photograph
+   by an experienced street photographer", "a frame from a Japanese anime TV series", "a two-color risograph print" or
+   "a flat scan of a handwritten recipe card". This sets the look more reliably than any style word.
+2. **Describe one scene.** Give a viewpoint, one main subject caught in a moment, a few supporting elements, and light
+   with a source and a direction.
+3. **Spell out every word.** Text without its exact words turns into pseudo-text. Put each piece of text in quotes,
+   keep each string short, say where it sits, and end with "no other text". If you want no text, don't mention signs
+   or labels at all.
+4. **Leave out hype words.** Stunning, epic, cinematic, vibrant, hyper-detailed, 8k or masterpiece push p-h3-image
+   toward a glossy, oversaturated, airbrushed look.
+
+<p align="center">
+  <img src="assets/prompt.jpg" width="100%">
+</p>
+
+*The first sentence says what the image is (bold), and every string that must appear is quoted (blue). The
+handwriting follows the quoted text almost word for word.*
+
+Styles that work especially well include documentary and editorial photography, portraits with real skin texture, film
+frames, TV-frame anime, ink and charcoal drawings, screen-printed posters and flat graphic design with short quoted
+text.
+
+<p align="center">
+  <img src="assets/styles.jpg" width="100%">
+</p>
+
+*Risograph print, child's crayon drawing, 1960s color photograph, 1970s film frame.*
+
+## Editing
+
+Pass one image to edit it, or a list of up to 8. Picture 1 is the image to edit, and the others are references the
+request can name as Picture 2, Picture 3 and so on. The upsampler writes the edit prompt in the form p-h3-image edits
+best from, so a short request such as "make the pickup truck red" is enough.
+
+<p align="center">
+  <img src="assets/edits.jpg" width="100%">
+</p>
+
+*The same short request given as typed (middle) and written as an edit prompt that names what to keep (right), the form
+the upsampler writes. As typed, p-h3-image often redraws the whole scene. As an edit prompt, only the requested part
+changes.*
+
+p-h3-image combines many references at once. Given up to 8 pictures and a one-line request, the upsampler names each
+picture and what to take from it, and p-h3-image composes them into one scene.
+
+<p align="center">
+  <img src="assets/multi_image.jpg" width="100%">
+</p>
+
+*Top, eight public-domain portraits and the dinner party p-h3-image composed from them, from a one-sentence request.
+Bottom, eight scientists at a poker table, seven presidents wading through the swamp with an astronaut, and characters
+from our own renders in the same swamp.*
+
+To write edit prompts without the upsampler, use this form.
+
+```txt
+Edit <Picture 1>. <The change, described as the finished result>. Keep <everything that must stay> exactly as it is.
+```
+
+- **Point to the exact thing.** Name the object, person or text you mean and where it is, such as "the old man's faded
+  blue cap" rather than "his hat".
+- **Describe the result, not the action.** Say how the edited part looks in the finished image, and give new things a
+  size next to something already there, such as "about the size of the cat's head".
+- **Say what stays.** List what must not change, such as faces, poses, the background and the light. Without this
+  list, p-h3-image tends to redraw the whole image.
+- **Quote new text exactly.** Put new text in quotes and name the text around it that must stay.
+
+## Performance
+
+One NVIDIA B200, bf16, batch size 1, 8 MP, no compilation or offloading.
+
+| | Time | Peak GPU memory |
+|---|:---:|:---:|
+| Text-to-image, prompt as written | about 9 s | 83 GB |
+| Prompt upsampler | 6 to 11 s more | 101 GB with the image model |
+
+The 8 steps run over the checkpoint's own sampling grid. Pass `sigmas` to use another one. There is no guider,
+`negative_prompt` or `guidance_scale`. For GPUs with less memory, use the int8 or w4a8 files in
+[PrunaAI/p-h3-image-comfy](https://huggingface.co/PrunaAI/p-h3-image-comfy).
+
+## Limitations
+
+- **It is sensitive to prompting.** Hype words and very long prompts make images worse, and very short prompts give
+  weak results without the upsampler.
+- **Hands can break, and small people in the background can come out distorted.** Rendering at 8 MP helps.
+- **Text is not fully reliable.** Small or dense text, such as body copy or long code, turns into pseudo-text, and
+  longer passages sometimes get single letters wrong. Short quoted strings render well.
+- **Lower resolutions show more artifacts.** At 2 and 4 MP, faces, hands and small details break more often than at
+  8 MP.
+- **Single images only.** p-h3-image does not generate video or audio.
+
+## License
+
+p-h3-image is based on MiniMax-H3 and released under the [MiniMax H3 Community License](LICENSE). Please read it before
+use. Among other terms, it excludes the European Union, the United Kingdom, the Republic of Korea and the United States
+unless you have a separate license from MiniMax, and products built on it must show "Powered by MiniMax H3". The text
+encoder's Qwen3-VL-4B parts and the prompt upsampler, based on Qwen3.5-9B, are under the
+[Apache License 2.0](LICENSE-APACHE). See [NOTICE](NOTICE) for details.
+
+p-h3-image would not exist without [MiniMax](https://huggingface.co/MiniMaxAI), who released H3 with open weights, and
+the [Qwen team](https://huggingface.co/Qwen).
+
+## What's next?
+
+- Compress your own models with [Pruna](https://github.com/PrunaAI/pruna) and give us a ⭐️ for more efficiency!
+- Want to use our optimized image models right away? Check [P-Image-Ideogram](https://www.pruna.ai/p-image-ideogram) and [P-Image-Edit](https://www.pruna.ai/p-image-edit).
+
+<style>
+.model-button {
+  display: inline-flex;
+  flex-direction: row;
+  justify-content: center;
+  align-items: center;
+  gap: 8px;
+
+  padding: 8px 20px;
+  border: none;
+  border-radius: 8px;
+
+  background: #9334e9;
+  color: #ffffff;
+
+  font-size: 14px;
+  font-weight: 400;
+  line-height: 1;
+  text-decoration: none;
+  white-space: nowrap;
+  cursor: pointer;
+
+  box-sizing: border-box;
+  overflow: visible;
+  opacity: 1;
+}
+</style>
+
+<a href="https://dashboard.pruna.ai/login?utm_source=huggingface&utm_medium=model_card&utm_campaign=hf_traffic" class="model-button">Try our models</a>