Text-to-Image
Diffusers
English
StableDiffusionXLPipeline
stable-diffusion
stable-diffusion-xl
sdxl
photorealistic
photography
cinematic
portrait
juggernaut
rundiffusion
kandooai
Instructions to use RunDiffusion/Juggernaut-XL-v9 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Diffusers
How to use RunDiffusion/Juggernaut-XL-v9 with Diffusers:
pip install -U diffusers transformers accelerate
import torch from diffusers import DiffusionPipeline # switch to "mps" for apple devices pipe = DiffusionPipeline.from_pretrained("RunDiffusion/Juggernaut-XL-v9", dtype=torch.bfloat16, device_map="cuda") prompt = "Astronaut in a jungle, cold color palette, muted colors, detailed, 8k" image = pipe(prompt).images[0] - Notebooks
- Google Colab
- Kaggle
- Local Apps
- Draw Things
- DiffusionBee
pull
#10
by karimalayan - opened
- .gitattributes +0 -2
- README.md +48 -165
- assets/Juggernaut_v9_banner.png +0 -3
- assets/Juggernaut_v9_banner.webp +0 -3
.gitattributes
CHANGED
|
@@ -33,5 +33,3 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
|
|
| 33 |
*.zip filter=lfs diff=lfs merge=lfs -text
|
| 34 |
*.zst filter=lfs diff=lfs merge=lfs -text
|
| 35 |
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
| 36 |
-
assets/Juggernaut_v9_banner.png filter=lfs diff=lfs merge=lfs -text
|
| 37 |
-
assets/Juggernaut_v9_banner.webp filter=lfs diff=lfs merge=lfs -text
|
|
|
|
| 33 |
*.zip filter=lfs diff=lfs merge=lfs -text
|
| 34 |
*.zst filter=lfs diff=lfs merge=lfs -text
|
| 35 |
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
|
|
|
|
|
README.md
CHANGED
|
@@ -1,185 +1,68 @@
|
|
| 1 |
---
|
| 2 |
-
license: creativeml-openrail-m
|
| 3 |
language:
|
| 4 |
- en
|
|
|
|
| 5 |
library_name: diffusers
|
| 6 |
-
pipeline_tag: text-to-image
|
| 7 |
-
base_model: stabilityai/stable-diffusion-xl-base-1.0
|
| 8 |
tags:
|
| 9 |
-
-
|
| 10 |
-
-
|
| 11 |
-
-
|
| 12 |
-
-
|
| 13 |
-
-
|
| 14 |
-
-
|
| 15 |
-
-
|
| 16 |
-
-
|
| 17 |
-
-
|
| 18 |
-
-
|
| 19 |
-
-
|
| 20 |
-
-
|
| 21 |
-
|
| 22 |
-
|
| 23 |
-
|
| 24 |
-
<a href="https://www.rundiffusion.com/juggernaut?utm_source=huggingface&utm_medium=model_card&utm_campaign=juggernaut_xl_v9&utm_content=header_banner">
|
| 25 |
-
<img src="https://huggingface.co/RunDiffusion/Juggernaut-XL-v9/resolve/main/assets/Juggernaut_v9_banner.webp" alt="Juggernaut XL v9 — by RunDiffusion" />
|
| 26 |
-
</a>
|
| 27 |
-
|
| 28 |
-
<h1>Juggernaut XL v9 by RunDiffusion</h1>
|
| 29 |
-
|
| 30 |
-
<p><i>The world's most-downloaded SDXL model — purpose-built for photorealism.</i></p>
|
| 31 |
-
|
| 32 |
-
<p><b>6M+ downloads on Hugging Face · Overwhelmingly Positive on Civitai · 26 months in production</b></p>
|
| 33 |
-
|
| 34 |
-
<p>
|
| 35 |
-
<a href="https://app.rundiffusion.com/login?utm_source=huggingface&utm_medium=model_card&utm_campaign=juggernaut_xl_v9&utm_content=hero_cta"><img alt="Try Juggernaut XL v9 — Free" src="https://img.shields.io/badge/%E2%96%B6%20Try%20Juggernaut%20XL%20v9%20%E2%80%94%20Free-7C3AED?style=for-the-badge&labelColor=7C3AED"></a>
|
| 36 |
-
</p>
|
| 37 |
-
|
| 38 |
-
<p>
|
| 39 |
-
<a href="https://www.rundiffusion.com/prompting?utm_source=huggingface&utm_medium=model_card&utm_campaign=juggernaut_xl_v9&utm_content=prompting_resource"><img alt="Prompting Guides" src="https://img.shields.io/badge/%F0%9F%93%96%20Prompting%20Guides-1f1f23?style=for-the-badge"></a> <a href="https://www.rundiffusion.com/juggernaut?utm_source=huggingface&utm_medium=model_card&utm_campaign=juggernaut_xl_v9&utm_content=lineup_compare"><img alt="Compare the Lineup" src="https://img.shields.io/badge/Compare%20the%20Lineup-1971c2?style=for-the-badge&labelColor=1f1f23"></a> <a href="https://civitai.com/models/133005/juggernaut-xl"><img alt="Civitai" src="https://img.shields.io/badge/Civitai-Overwhelmingly%20Positive-EAB308?style=for-the-badge&labelColor=1f1f23"></a> <img alt="License: CreativeML Open RAIL-M" src="https://img.shields.io/badge/License-OpenRAIL--M-2ea44f?style=for-the-badge">
|
| 40 |
-
</p>
|
| 41 |
-
|
| 42 |
-
</div>
|
| 43 |
-
|
| 44 |
-
> Juggernaut XL is the most popular SDXL fine-tune in the world. Version 9 — co-developed by **KandooAI** and **RunDiffusion**, integrating **RunDiffusion Photo v2** — is the proven photorealism workhorse trusted by **hundreds of thousands of creators**: 6M+ all-time downloads on Hugging Face, 1.5M+ on Civitai, and an *Overwhelmingly Positive* rating across 7,780+ reviews.
|
| 45 |
-
|
| 46 |
-
## Why Juggernaut XL v9 in 2026?
|
| 47 |
-
|
| 48 |
-
The SDXL ecosystem is the single most mature corner of open image generation, and v9 is its most refined photorealism checkpoint. Choose Juggernaut XL v9 when you want:
|
| 49 |
-
|
| 50 |
-
- 📸 **Photorealism that holds up under scrutiny** — skin texture, micro-contrast, and natural lighting that translates from concept to print.
|
| 51 |
-
- 💻 **Reasonable hardware** — runs comfortably on 8 GB of VRAM, unlike newer DiT-based models that demand 16+ GB.
|
| 52 |
-
- 🧰 **The full SDXL toolbox** — drop-in compatibility with the thousands of SDXL ControlNets, IP-Adapter variants, AnimateDiff, regional prompting tools, and LoRAs already in your workflow.
|
| 53 |
-
- 🏆 **Battle-tested reliability** — 26+ months in production, used in agencies, studios, and shipping products around the world.
|
| 54 |
-
|
| 55 |
-
For experimental and frontier work, see the rest of the [Juggernaut family](#looking-for-something-newer). For SDXL photorealism, this is the king of the hill.
|
| 56 |
-
|
| 57 |
-
---
|
| 58 |
-
|
| 59 |
-
<div align="center">
|
| 60 |
-
|
| 61 |
-
<h3>🚀 Skip the setup. Try Juggernaut XL v9 in your browser.</h3>
|
| 62 |
-
|
| 63 |
-
<p>No installs. No GPU rental. No model downloads. <b>Just generate.</b></p>
|
| 64 |
-
|
| 65 |
-
<a href="https://app.rundiffusion.com/login?utm_source=huggingface&utm_medium=model_card&utm_campaign=juggernaut_xl_v9&utm_content=midpage_cta"><img alt="Launch Juggernaut on RunDiffusion" src="https://img.shields.io/badge/%E2%96%B6%20Launch%20on%20RunDiffusion-7C3AED?style=for-the-badge&labelColor=7C3AED"></a>
|
| 66 |
-
|
| 67 |
-
<p><i>Pre-loaded into ComfyUI · Forge · Automatic1111 · Fooocus · InvokeAI · SwarmUI</i></p>
|
| 68 |
-
|
| 69 |
-
</div>
|
| 70 |
-
|
| 71 |
---
|
| 72 |
|
| 73 |
-
#
|
| 74 |
-
|
| 75 |
-
|
| 76 |
-
- Improved **skin detail** and micro-texture rendering
|
| 77 |
-
- Stronger **lighting** and **contrast** control
|
| 78 |
-
- Better consistency across **portrait**, **architecture**, **automotive**, **wildlife**, **food**, **interior**, and **landscape** photography
|
| 79 |
-
|
| 80 |
-
## Two Ways to Run Juggernaut XL v9
|
| 81 |
-
|
| 82 |
-
### 🚀 Easiest — Run it on RunDiffusion (recommended)
|
| 83 |
-
|
| 84 |
-
One-click access to Juggernaut XL v9 inside the UI you already know — ComfyUI, Forge, Automatic1111, Fooocus, InvokeAI, or SwarmUI. No setup, no model downloads, no GPU to rent. **Free trial included.**
|
| 85 |
-
|
| 86 |
-
<div align="center">
|
| 87 |
-
<a href="https://app.rundiffusion.com/login?utm_source=huggingface&utm_medium=model_card&utm_campaign=juggernaut_xl_v9&utm_content=quickstart_try"><img alt="Get Started Free" src="https://img.shields.io/badge/Get%20Started%20Free%20%E2%86%92-7C3AED?style=for-the-badge&labelColor=7C3AED"></a>
|
| 88 |
-
</div>
|
| 89 |
-
|
| 90 |
-
### 💻 Or run it locally — Diffusers
|
| 91 |
-
|
| 92 |
-
```python
|
| 93 |
-
import torch
|
| 94 |
-
from diffusers import DiffusionPipeline
|
| 95 |
-
|
| 96 |
-
pipe = DiffusionPipeline.from_pretrained(
|
| 97 |
-
"RunDiffusion/Juggernaut-XL-v9",
|
| 98 |
-
torch_dtype=torch.float16,
|
| 99 |
-
variant="fp16",
|
| 100 |
-
use_safetensors=True,
|
| 101 |
-
).to("cuda")
|
| 102 |
-
|
| 103 |
-
prompt = "Cinematic mid shot photo of an astronaut walking through a neon-lit Tokyo alley at night, hyperdetailed photography, skin details, shallow depth of field"
|
| 104 |
-
|
| 105 |
-
image = pipe(
|
| 106 |
-
prompt,
|
| 107 |
-
width=832, height=1216,
|
| 108 |
-
num_inference_steps=35,
|
| 109 |
-
guidance_scale=5.0,
|
| 110 |
-
).images[0]
|
| 111 |
-
|
| 112 |
-
image.save("juggernaut_xl_v9.png")
|
| 113 |
-
```
|
| 114 |
-
|
| 115 |
-
For ComfyUI / Forge / InvokeAI / SwarmUI: download `Juggernaut-XL_v9_RunDiffusionPhoto_v2.safetensors` and drop it into your `models/checkpoints/` directory.
|
| 116 |
|
| 117 |
-
|
| 118 |
|
| 119 |
-
|
| 120 |
-
| --- | --- |
|
| 121 |
-
| Resolution | `832 × 1216` (portrait) · `1216 × 832` (landscape) |
|
| 122 |
-
| Sampler | `DPM++ 2M Karras` |
|
| 123 |
-
| Steps | `30 – 40` |
|
| 124 |
-
| CFG scale | `3 – 7` (lower = more realistic) |
|
| 125 |
-
| VAE | **Already baked in** — no external VAE required |
|
| 126 |
-
| Hi-Res fix | `4xNMKD-Siax_200k` upscaler · 15 steps · 0.3 denoise · 1.5× upscale |
|
| 127 |
|
| 128 |
-
|
| 129 |
|
| 130 |
-
|
| 131 |
|
| 132 |
-
|
| 133 |
|
| 134 |
-
|
| 135 |
-
Architecture Photography · Wildlife Photography · Car Photography
|
| 136 |
-
Food Photography · Interior Photography · Landscape Photography
|
| 137 |
-
Hyperdetailed Photography · Cinematic Movie · Still Mid Shot Photo
|
| 138 |
-
Full Body Photo · Skin Details
|
| 139 |
-
```
|
| 140 |
|
| 141 |
-
|
| 142 |
-
|
| 143 |
-
## Files In This Repo
|
| 144 |
-
|
| 145 |
-
| File | Purpose |
|
| 146 |
-
| --- | --- |
|
| 147 |
-
| `Juggernaut-XL_v9_RunDiffusionPhoto_v2.safetensors` | Single-file checkpoint for ComfyUI / Forge / InvokeAI / SwarmUI |
|
| 148 |
-
| `unet/`, `text_encoder/`, `text_encoder_2/`, `vae/`, `tokenizer/`, `tokenizer_2/`, `scheduler/`, `model_index.json` | Diffusers-format directory tree (FP16 variant) for `from_pretrained` |
|
| 149 |
-
|
| 150 |
-
## Looking For Something Newer?
|
| 151 |
-
|
| 152 |
-
The Juggernaut family has continued to evolve. Match the model to your project:
|
| 153 |
-
|
| 154 |
-
| Model | Architecture | Best for |
|
| 155 |
-
| --- | --- | --- |
|
| 156 |
-
| **[Juggernaut Z](https://huggingface.co/RunDiffusion/Juggernaut-Z-Image)** | Lumina-Image-2 | Cinematic, presentation-ready output with stronger lighting and atmosphere |
|
| 157 |
-
| **[Juggernaut Pro Flux](https://www.rundiffusion.com/juggernaut-pro-flux?utm_source=huggingface&utm_medium=model_card&utm_campaign=juggernaut_xl_v9&utm_content=cross_promo_pro_flux)** | FLUX.1 | Highest photo quality with strong consistency and lower token cost |
|
| 158 |
-
| **[Juggernaut XII / XIII Ragnarok](https://www.rundiffusion.com/juggernaut?utm_source=huggingface&utm_medium=model_card&utm_campaign=juggernaut_xl_v9&utm_content=cross_promo_family)** | SDXL | The latest evolutions of the SDXL line, refined for prompt adherence and realism |
|
| 159 |
-
| **Juggernaut XL v9** *(this model)* | SDXL 1.0 | Proven SDXL photorealism workhorse with the broadest tooling ecosystem |
|
| 160 |
-
|
| 161 |
-
All of them — and 100+ other SOTA models — are pre-loaded on **[RunDiffusion](https://app.rundiffusion.com/login?utm_source=huggingface&utm_medium=model_card&utm_campaign=juggernaut_xl_v9&utm_content=family_compare)**. Switch between them in two clicks.
|
| 162 |
-
|
| 163 |
-
## Commercial Use
|
| 164 |
-
|
| 165 |
-
This model **may not be deployed behind paid API services** without explicit licensing. For commercial licensing, custom models, business inquiries, or consultation, contact **[juggernaut@rundiffusion.com](mailto:juggernaut@rundiffusion.com)**.
|
| 166 |
-
|
| 167 |
-
You are free to use this model for personal and creative work under the terms of the [CreativeML Open RAIL-M license](https://huggingface.co/spaces/CompVis/stable-diffusion-license).
|
| 168 |
-
|
| 169 |
-
## Credits
|
| 170 |
-
|
| 171 |
-
Juggernaut XL v9 was created by **[KandooAI](https://twitter.com/Juggernaut_AI)** in collaboration with **[RunDiffusion](https://www.rundiffusion.com/?utm_source=huggingface&utm_medium=model_card&utm_campaign=juggernaut_xl_v9&utm_content=credits)**. The photographic backbone — **RunDiffusion Photo v2** — was developed by the RunDiffusion team. Thanks to **Adam Stewart** for prompting workflow.
|
| 172 |
-
|
| 173 |
-
---
|
| 174 |
|
| 175 |
-
|
| 176 |
|
| 177 |
-
|
| 178 |
|
| 179 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
| 180 |
|
| 181 |
-
|
|
|
|
|
|
|
| 182 |
|
| 183 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 184 |
|
| 185 |
-
|
|
|
|
| 1 |
---
|
|
|
|
| 2 |
language:
|
| 3 |
- en
|
| 4 |
+
license: creativeml-openrail-m
|
| 5 |
library_name: diffusers
|
|
|
|
|
|
|
| 6 |
tags:
|
| 7 |
+
- art
|
| 8 |
+
- people
|
| 9 |
+
- diffusion
|
| 10 |
+
- Cinematic
|
| 11 |
+
- Photography
|
| 12 |
+
- Landscape
|
| 13 |
+
- Interior
|
| 14 |
+
- Food
|
| 15 |
+
- Car
|
| 16 |
+
- Wildlife
|
| 17 |
+
- Architecture
|
| 18 |
+
thumbnail: >-
|
| 19 |
+
https://imagedelivery.net/siANnpeNAc_S2q1M3-eDrA/c200a026-c151-49c7-afbc-241fe943b300/padthumb
|
| 20 |
+
base_model: stabilityai/stable-diffusion-xl-base-1.0
|
| 21 |
+
pipeline_tag: text-to-image
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 22 |
---
|
| 23 |
|
| 24 |
+
# Juggernaut XL v9 + RunDiffusion Photo v2 Official
|
| 25 |
+
[](https://rundiffusion.com)
|
| 26 |
+
Check out the team behind this amazing model! We're happy to help you build your Ai models!
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 27 |
|
| 28 |
+

|
| 29 |
|
| 30 |
+
This model is not permitted to be used behind API services. Please contact [juggernaut@rundiffusion.com](mailto:juggernaut@rundiffusion.com) for business inquires, commercial licensing, custom models, and consultation.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 31 |
|
| 32 |
+
Juggernaut is available on the new Auto1111 Forge on [RunDiffusion](http://rundiffusion.com/?utm_source=huggingface&utm_medium=referral&utm_campaign=Kandoo)
|
| 33 |
|
| 34 |
+
A big thanks for Version 9 goes to [RunDiffusion](http://rundiffusion.com/?utm_source=huggingface&utm_medium=referral&utm_campaign=Kandoo) ([Photo Model](https://rundiffusion.com/rundiffusion-photo/?utm_source=huggingface&utm_medium=referral&utm_campaign=Kandoo)) and [Adam](https://twitter.com/Colorblind_Adam), who diligently helped me test :) (Leave some love for them ;) )
|
| 35 |
|
| 36 |
+
It's time for another round, this time a bit delayed, but I hope you forgive the delay. Let's dive straight into the changes that await you or what we've been working on lately:
|
| 37 |
|
| 38 |
+
For V9, I myself have only done basic training. This involves some work on skin details, lighting, and overall contrast. However, the biggest change to the model came from the [RunDiffusion Photo Model](https://rundiffusion.com/rundiffusion-photo/?utm_source=huggingface&utm_medium=referral&utm_campaign=Kandoo) update, which was made available to me in V2 by [RunDiffusion.com](https://rundiffusion.com/?utm_source=huggingface&utm_medium=referral&utm_campaign=Kandoo). The photographic output of the model should, in our experience, be even stronger than in previous versions.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 39 |
|
| 40 |
+
Now for a small "roadmap" update, or a general status update on how things are progressing with Juggernaut. As you may have noticed, there was a slight delay with V9. With each successive version, it has become increasingly difficult to train Juggernaut without sacrificing quality in some areas, which was already the case to some extent with V8. Don't worry, V9 is really good, and I'm satisfied with the version I can present to you today :) However, I've decided to go for a complete "reboot" for V10. I want to simply retrain the Juggernaut base set. The conditions for better captioning weren't as favorable "back then" as they are today, so I want to completely re-caption the base set (5k images) with GPT-4 Vision. I expect a big leap towards prompting guidance and quality.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 41 |
|
| 42 |
+
But as you surely noticed last week, the release of Stable Cascade got in the way a bit. Therefore, my focus in the coming weeks will be on training Juggernaut for Stable Cascade. The approach remains the same as with the planned "reboot"; I want to caption/tag all images in the future only with GPT-4 or manually. The timeline for all of this is still uncertain. I hope to be able to present you with a first stable version of Juggernaut Cascade sometime in March. V10 of Juggernaut XL will follow in the weeks thereafter.
|
| 43 |
|
| 44 |
+
Now, here are some additional tips to make prompting easier for you:
|
| 45 |
|
| 46 |
+
- Res: 832x1216
|
| 47 |
+
- Sampler: DPM++ 2M Karras
|
| 48 |
+
- Steps: 30-40 CFG: 3-7 (less is
|
| 49 |
+
a bit more realistic)
|
| 50 |
+
- Negative: Start with no negative, and add afterwards the Stuff you don't want to see in that image. I don't recommend using my Negative Prompt, i simply use it because i am lazy :D
|
| 51 |
|
| 52 |
+
VAE is already Baked In
|
| 53 |
+
HiRes: 4xNMKD-Siax_200k with 15 Steps and 0.3 Denoise + 1.5 Upscale
|
| 54 |
+
And a few keywords/tokens that I regularly use in training, which might help you achieve the optimal result from the version:
|
| 55 |
|
| 56 |
+
- Architecture Photography
|
| 57 |
+
- Wildlife Photography
|
| 58 |
+
- Car Photography
|
| 59 |
+
- Food Photography
|
| 60 |
+
- Interior Photography
|
| 61 |
+
- Landscape Photography
|
| 62 |
+
- Hyperdetailed Photography
|
| 63 |
+
- Cinematic Movie
|
| 64 |
+
- Still Mid Shot Photo
|
| 65 |
+
- Full Body Photo
|
| 66 |
+
- Skin Details
|
| 67 |
|
| 68 |
+

|
assets/Juggernaut_v9_banner.png
DELETED
Git LFS Details
|
assets/Juggernaut_v9_banner.webp
DELETED
Git LFS Details
|