> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# PixelDiT ComfyUI Workflow Example

> PixelDiT is NVIDIA's pixel-space diffusion transformer for 1024px text-to-image generation. It operates directly in pixel space: no VAE encode/decode required.

**PixelDiT** is NVIDIA's pixel-space diffusion transformer for 1024px text-to-image generation. Unlike traditional diffusion models that operate in latent space, PixelDiT generates images directly in pixel space using a dual-level DiT architecture: a patch-level DiT combined with a pixel-level DiT: with MM-DiT fusion for joint attention between text and image tokens.

**Model Highlights**:

* **VAE-free**: generates directly in pixel space; no traditional VAE encode/decode
* **Dual-level DiT**: patch-level DiT + pixel-level DiT for high-quality generation
* **Multi aspect ratio**: 1024px base resolution with support for several aspect ratios
* **\~1.3B parameters**: efficient enough for consumer GPUs
* **License**: NSCLv1 (non-commercial research/evaluation only)

**Related Links**:

* [Official model on Hugging Face](https://huggingface.co/nvidia/PixelDiT-1300M-1024px)
* [Comfy-Org/PixelDiT](https://huggingface.co/Comfy-Org/PixelDiT)

## PixelDiT text-to-image workflow

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/image_pixeldit_t2i-1.webp" alt="PixelDiT text-to-image workflow" />

<CardGroup cols={2}>
  <Card title="Download Workflow" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/image_pixeldit_t2i.json">
    Download JSON or search "PixelDiT" in Template Library
  </Card>

  <Card title="Run on Comfy Cloud" icon="cloud" href="https://cloud.comfy.org/?template=image_pixeldit_t2i&utm_source=docs&utm_medium=referral&utm_campaign=pixeldit">
    Open in cloud
  </Card>
</CardGroup>

<Tip>
  <Tabs>
    <Tab title="Local users">
      Make sure your ComfyUI is updated.

      * [Download ComfyUI](https://www.comfy.org/download)
      * [Update Guide](/installation/update_comfyui)

      Workflows in this guide can be found in the [Workflow Templates](/interface/features/template).
      If you can't find them in the template, your ComfyUI may be outdated.

      If nodes are missing when loading a workflow, possible reasons:

      1. You are not using the latest ComfyUI version (Nightly version)
      2. Some nodes failed to import at startup
    </Tab>

    <Tab title="Cloud users">
      * [Cloud](https://cloud.comfy.org) will update after ComfyUI stable release.

      So, if you find any core node missing in this document, it might be because the new core nodes have not yet been released in the latest stable version. Please wait for the next stable release.
    </Tab>
  </Tabs>
</Tip>

The workflow consists of three main nodes:

1. **ResolutionSelector**: choose your desired output resolution
2. **Text to Image (PixelDiT) subgraph**: the core generation node with exposed controls for prompt, seed, model selection and resolution
3. **SaveImage**: saves the generated image

<Card title="Learn about Subgraph" icon="book-open" href="/interface/features/subgraph">
  This workflow uses Subgraph nodes for modular processing. Check out the Subgraph documentation to learn how to customize and extend the workflow.
</Card>

### Workflow controls

The exposed controls on the **Text to Image (PixelDiT)** subgraph node include:

| Control             | Description                                               |
| ------------------- | --------------------------------------------------------- |
| **Positive Prompt** | The text prompt describing the image you want to generate |
| **Negative Prompt** | Text describing what to avoid in the generated image      |
| **Seed**            | Random seed for reproducibility                           |
| **UNet Model**      | PixelDiT model checkpoint selection                       |
| **CLIP Model**      | Text encoder model selection                              |

## Model downloads

PixelDiT uses two model files: a text encoder and the diffusion model.

<CardGroup cols={2}>
  <Card title="Text Encoder" icon="download" href="https://huggingface.co/Comfy-Org/PixelDiT/blob/main/text_encoders/gemma_2_2b_it_elm_bf16.safetensors">
    gemma\_2\_2b\_it\_elm\_bf16.safetensors: Gemma-2-2B-IT text encoder
  </Card>

  <Card title="Diffusion Model" icon="download" href="https://huggingface.co/Comfy-Org/PixelDiT/blob/main/diffusion_models/pixeldit_1300m_1024px_bf16.safetensors">
    pixeldit\_1300m\_1024px\_bf16.safetensors: PixelDiT 1300M 1024px diffusion model
  </Card>
</CardGroup>

### Model storage location

```
📂 ComfyUI/
├── 📂 models/
│   ├── 📂 text_encoders/
│   │      └── gemma_2_2b_it_elm_bf16.safetensors
│   └── 📂 diffusion_models/
│          └── pixeldit_1300m_1024px_bf16.safetensors
```
