ERNIE-AIO / README.md
SeeSee21's picture
Update README.md
b5c6ea0 verified
|
Raw
History Blame Contribute Delete
7.64 kB
---
pipeline_tag: text-to-image
tags:
- text-to-image
- image-generation
- diffusion-transformer
- dit
- comfyui
- checkpoint
- safetensors
- aio
- all-in-one
- ernie-image
- ernie-image-turbo
- bf16
- fp8
license: apache-2.0
widget:
- text: >-
A premium sci-fi poster with readable text, cinematic lighting, and a
futuristic city skyline at night.
- text: >-
A clean product advertisement for a coffee brand with readable package text,
elegant layout, and warm morning light.
language:
- en
---
# πŸ–ΌοΈ ERNIE AIO for ComfyUI
**All-in-One Checkpoints β€’ Base + Turbo β€’ BF16 & FP8 β€’ Text Encoder + VAE Included**
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![ComfyUI](https://img.shields.io/badge/ComfyUI-Compatible-green.svg)](https://github.com/comfyanonymous/ComfyUI)
---
- [πŸ“¦ Models](#πŸ“¦-models "πŸ“¦ Models")
- [πŸ“‹ Workflow](#πŸ“‹-workflow "πŸ“‹ Workflow")
- [πŸ“Έ ERNIE-AIO-Base](#πŸ“Έ-ernie-aio-base "πŸ“Έ ERNIE-AIO-Base")
- [⚑ ERNIE-AIO-Turbo](#⚑-ernie-aio-turbo "⚑ ERNIE-AIO-Turbo")
- [πŸ”„ FP8 vs BF16](#πŸ”„-fp8-vs-bf16 "πŸ”„ FP8 vs BF16")
- [βš™οΈ Common Settings](#βš™οΈ-common-settings "βš™οΈ Common Settings")
- [πŸ—‚οΈ Prompt Enhancer](#πŸ—‚οΈ-prompt-enhancer "πŸ—‚οΈ Prompt Enhancer")
- [πŸ’‘ Prompting](#πŸ’‘-prompting "πŸ’‘ Prompting")
- [πŸ“₯ Downloads](#πŸ“₯-downloads "πŸ“₯ Downloads")
- [πŸ“ Files](#πŸ“-files "πŸ“ Files")
- [πŸ™ Credits](#πŸ™-credits "πŸ™ Credits")
---
## πŸ“¦ Models
| Model | Style | FP8 | BF16 | Best For |
|---|---|---|---|---|
| πŸ“Έ **ERNIE-AIO-Base** | Realistic / Structured | βœ… | βœ… | High-quality, refined output |
| ⚑ **ERNIE-AIO-Turbo** | Realistic / Structured | βœ… | βœ… | Fast iteration, 8-step generation |
**All models:** Integrated Text Encoder + VAE β€’ Single Checkpoint β€’ No extra loaders needed
---
## πŸ“‹ Workflow
| File | Description |
|---|---|
| `Workflow/ERNIE-AIO-Upscale.json` | Standard ComfyUI workflow with upscaler |
> βœ… A ready-to-use **ComfyUI workflow** is included in the `Workflow/` folder.
> βœ… Optional **Prompt Enhancer** files are included in the `prompt-enhancer/` folder.
---
## πŸ“Έ ERNIE-AIO-Base
The Base version is intended for high-quality, deliberate, and stable generation.
**Features:** πŸ“– Strong instruction following β€’ πŸ–‹οΈ Text rendering β€’ πŸ“ Structured layouts
```
Steps: 50 | CFG: 4.0
```
[![ERNIE-AIO-Base preview](https://huggingface.co/SeeSee21/ERNIE-AIO/resolve/main/images/ernie-aio-base.png)](https://huggingface.co/SeeSee21/ERNIE-AIO/blob/main/images/ernie-aio-base.png)
Use this version when you want:
- Stronger refinement and more careful rendering
- Full non-turbo quality
- Best results for posters, infographics, and text-heavy layouts
---
## ⚑ ERNIE-AIO-Turbo
The Turbo version is a distilled variant for fast generation and quick iteration.
**Features:** ⚑ 8-step generation β€’ 🎯 High prompt fidelity β€’ πŸš€ Quick turnaround
```
Steps: 8 | CFG: 1.0
```
[![ERNIE-AIO-Turbo preview](https://huggingface.co/SeeSee21/ERNIE-AIO/resolve/main/images/ernie-aio-turbo.png)](https://huggingface.co/SeeSee21/ERNIE-AIO/blob/main/images/ernie-aio-turbo.png)
Use this version when you want:
- Fast output for prototyping and iteration
- Strong visual quality with minimal steps
- Efficient VRAM usage
---
## πŸ”„ FP8 vs BF16
| | 🟑 FP8 | 🌟 BF16 |
|---|---|---|
| **Quality** | ~95% | 100% |
| **File Size** | Smaller | Full |
| **Speed** | Faster | Standard |
| **VAE** | FP32 (stable) | FP32 (stable) |
| **Best For** | Daily use | Final renders |
> **Note:** The FP8 versions in this repository were quantized by me.
> VAE is kept at **FP32** in all variants for stable decoding.
---
## βš™οΈ Common Settings
```
# ERNIE-AIO-Base
Steps: 50
CFG: 4.0
# ERNIE-AIO-Turbo
Steps: 8
CFG: 1.0
# Placement (both variants)
ComfyUI/models/checkpoints/
# Loader
Standard "Load Checkpoint" node β€” no extra VAE or text encoder loader needed
```
**Minimal workflow:**
1. **Checkpoint Loader**
2. **CLIP Text Encode (Prompt)**
3. **Empty Latent Image**
4. **KSampler**
5. **VAE Decode**
6. **Save Image**
---
## πŸ—‚οΈ Prompt Enhancer
An optional **Prompt Enhancer** is included in the `prompt-enhancer/` folder.
- Automatically expands short prompts into richer, more descriptive prompts
- Used by the included workflow
- Fully optional β€” works without it too
> ⚠️ **Placement:** The Prompt Enhancer files must be placed in:
> ```
> ComfyUI/models/text_encoders/
> ```
> **Not** in a `prompt-enhancer/` subfolder β€” place the files directly into `text_encoders/`.
---
## πŸ’‘ Prompting
**Natural language works best!** These models excel at instruction following and text rendering.
```
βœ… A cinematic movie poster with a bold readable title at the top,
dramatic lighting, a futuristic skyline in the background,
and a heroic figure silhouetted against a neon-lit city.
❌ movie poster, city, hero, cinematic, dramatic
```
**ERNIE-Image is especially strong for:**
| Category | Examples |
|---|---|
| 🎬 Posters & Title Cards | Movie posters, event flyers, title images |
| β˜• Product Ads | Coffee brands, packaging with readable text |
| πŸ“Š Infographics | Labeled sections, structured layouts |
| πŸ’¬ Comics | Speech bubbles, panel compositions |
| πŸ–₯️ UI-style Visuals | Interface mockups, app screens |
| πŸ–ΌοΈ Realistic Imagery | Portraits, environments, product shots |
**For best results, describe:**
- Subject & environment
- Composition & layout
- Mood & lighting
- Camera framing
- Any text that should appear in the image
---
## πŸ“₯ Downloads
### ERNIE-AIO Checkpoints
| Model | Precision | CivitAI |
|---|---|---|
| ⚑ **ERNIE-AIO-Turbo** | 🌟 BF16 | [Download](https://civitai.red/models/2551548?modelVersionId=2868512) |
| ⚑ **ERNIE-AIO-Turbo** | 🟑 FP8 | [Download](https://civitai.red/models/2551548?modelVersionId=2868512) |
| πŸ“Έ **ERNIE-AIO-Base** | 🌟 BF16 | [Download](https://civitai.red/models/2551548?modelVersionId=2867462) |
| πŸ“Έ **ERNIE-AIO-Base** | 🟑 FP8 | [Download](https://civitai.red/models/2551548?modelVersionId=2867462) |
> All files are also available directly on this HuggingFace page.
---
## πŸ“ Files
```
β”œβ”€β”€ ERNIE-AIO-Base-bf16.safetensors # πŸ“Έ Base β€” BF16
β”œβ”€β”€ ERNIE-AIO-Base-fp8.safetensors # πŸ“Έ Base β€” FP8
β”œβ”€β”€ ERNIE-AIO-Turbo-bf16.safetensors # ⚑ Turbo β€” BF16
β”œβ”€β”€ ERNIE-AIO-Turbo-fp8.safetensors # ⚑ Turbo β€” FP8
β”‚
β”œβ”€β”€ Workflow/
β”‚ └── ERNIE-AIO-Upscale.json # πŸš€ ComfyUI workflow with upscaler
β”‚
β”œβ”€β”€ prompt-enhancer/ # πŸ—‚οΈ Optional Prompt Enhancer files
β”‚
└── images/
β”œβ”€β”€ ernie-aio-base.png # πŸ“Έ Base preview image
└── ernie-aio-turbo.png # ⚑ Turbo preview image
```
---
## πŸ™ Credits
**Original Model:** Baidu ERNIE-Image Team β€’ Single-Stream DiT β€’ Apache 2.0
**AIO Conversion & FP8 Quantization:** [SeeSee21](https://huggingface.co/SeeSee21)
**Official Sources:**
| Resource | Link |
|---|---|
| ERNIE-Image (HuggingFace) | [baidu/ERNIE-Image](https://huggingface.co/baidu/ERNIE-Image) |
| ERNIE-Image-Turbo (HuggingFace) | [baidu/ERNIE-Image-Turbo](https://huggingface.co/baidu/ERNIE-Image-Turbo) |
| GitHub | [baidu/ERNIE-Image](https://github.com/baidu/ERNIE-Image) |
---
**Download β†’ Load Checkpoint β†’ Generate!** πŸš€
**Place in `checkpoints/`, load with "Load Checkpoint", and generate in seconds!**