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
Refresh model card: banner header, social proof, cleaned content, family cross-links, drop stale roadmap and Auto1111 refs
Browse files
README.md
CHANGED
|
@@ -1,68 +1,142 @@
|
|
| 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 |
-
|
| 25 |
-
|
| 26 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 27 |
|
| 28 |
-
|
| 29 |
|
| 30 |
-
|
| 31 |
|
| 32 |
-
|
|
|
|
|
|
|
|
|
|
| 33 |
|
| 34 |
-
|
| 35 |
|
| 36 |
-
|
| 37 |
|
| 38 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 39 |
|
| 40 |
-
|
| 41 |
|
| 42 |
-
|
| 43 |
|
| 44 |
-
|
| 45 |
|
| 46 |
-
|
| 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 |
-
|
| 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 |
-
|
| 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 |
-
|
|
|
|
|
|
|
|
|
|
|
|
| 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 |
+
- stable-diffusion
|
| 10 |
+
- stable-diffusion-xl
|
| 11 |
+
- sdxl
|
| 12 |
+
- text-to-image
|
| 13 |
+
- photorealistic
|
| 14 |
+
- photography
|
| 15 |
+
- cinematic
|
| 16 |
+
- portrait
|
| 17 |
+
- juggernaut
|
| 18 |
+
- rundiffusion
|
| 19 |
+
- kandooai
|
| 20 |
---
|
| 21 |
|
| 22 |
+
<div align="center">
|
| 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.png" 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>
|
| 33 |
+
<a href="https://www.rundiffusion.com/juggernaut-xl?utm_source=huggingface&utm_medium=model_card&utm_campaign=juggernaut_xl_v9&utm_content=cta_primary"><img alt="Run Juggernaut XL on RunDiffusion" src="https://img.shields.io/badge/%E2%96%B6%20Run%20on%20RunDiffusion-7C3AED?style=for-the-badge&labelColor=7C3AED"></a> <a href="https://civitai.com/models/133005/juggernaut-xl"><img alt="Civitai" src="https://img.shields.io/badge/Civitai-Overwhelmingly%20Positive-1971c2?style=for-the-badge&labelColor=1f1f23"></a> <a href="https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0"><img alt="Base Model: SDXL 1.0" src="https://img.shields.io/badge/%F0%9F%A4%97%20Base%20Model-SDXL%201.0-FFD21E?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">
|
| 34 |
+
</p>
|
| 35 |
+
|
| 36 |
+
</div>
|
| 37 |
+
|
| 38 |
+
> 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**: 1.5M+ downloads on Civitai, 100K+ monthly downloads on Hugging Face, and an *Overwhelmingly Positive* rating across 7,780+ reviews.
|
| 39 |
+
|
| 40 |
+
## Why Juggernaut XL v9 in 2026?
|
| 41 |
+
|
| 42 |
+
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:
|
| 43 |
+
|
| 44 |
+
- **Photorealism that holds up under scrutiny** β skin texture, micro-contrast, and natural lighting that translates from concept to print.
|
| 45 |
+
- **Reasonable hardware** β runs comfortably on 8 GB of VRAM, unlike newer DiT-based models that demand 16+ GB.
|
| 46 |
+
- **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.
|
| 47 |
+
- **Battle-tested reliability** β 17+ months in production, used in agencies, studios, and shipping products around the world.
|
| 48 |
+
|
| 49 |
+
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.
|
| 50 |
+
|
| 51 |
+
## What V9 Brought Over V8
|
| 52 |
+
|
| 53 |
+
- **RunDiffusion Photo v2** integration β a substantial upgrade in the photographic backbone of the model
|
| 54 |
+
- Improved **skin detail** and micro-texture rendering
|
| 55 |
+
- Stronger **lighting** and **contrast** control
|
| 56 |
+
- Better consistency across **portrait**, **architecture**, **automotive**, **wildlife**, **food**, **interior**, and **landscape** photography
|
| 57 |
+
|
| 58 |
+
## Recommended Settings
|
| 59 |
+
|
| 60 |
+
| Parameter | Value |
|
| 61 |
+
| --- | --- |
|
| 62 |
+
| Resolution | `832 Γ 1216` (portrait) Β· `1216 Γ 832` (landscape) |
|
| 63 |
+
| Sampler | `DPM++ 2M Karras` |
|
| 64 |
+
| Steps | `30 β 40` |
|
| 65 |
+
| CFG scale | `3 β 7` (lower = more realistic) |
|
| 66 |
+
| VAE | **Already baked in** β no external VAE required |
|
| 67 |
+
| Hi-Res fix | `4xNMKD-Siax_200k` upscaler Β· 15 steps Β· 0.3 denoise Β· 1.5Γ upscale |
|
| 68 |
+
|
| 69 |
+
> **Negative prompts:** start with **none**. Add specific things you don't want as you iterate. Heavy negatives often hurt more than they help on this model.
|
| 70 |
+
|
| 71 |
+
## Useful Prompt Keywords
|
| 72 |
+
|
| 73 |
+
These are tokens trained into the model that reliably steer output:
|
| 74 |
+
|
| 75 |
+
```
|
| 76 |
+
Architecture Photography Β· Wildlife Photography Β· Car Photography
|
| 77 |
+
Food Photography Β· Interior Photography Β· Landscape Photography
|
| 78 |
+
Hyperdetailed Photography Β· Cinematic Movie Β· Still Mid Shot Photo
|
| 79 |
+
Full Body Photo Β· Skin Details
|
| 80 |
+
```
|
| 81 |
+
|
| 82 |
+
## Quick Start (Diffusers)
|
| 83 |
+
|
| 84 |
+
```python
|
| 85 |
+
import torch
|
| 86 |
+
from diffusers import DiffusionPipeline
|
| 87 |
+
|
| 88 |
+
pipe = DiffusionPipeline.from_pretrained(
|
| 89 |
+
"RunDiffusion/Juggernaut-XL-v9",
|
| 90 |
+
torch_dtype=torch.float16,
|
| 91 |
+
variant="fp16",
|
| 92 |
+
use_safetensors=True,
|
| 93 |
+
).to("cuda")
|
| 94 |
+
|
| 95 |
+
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"
|
| 96 |
+
|
| 97 |
+
image = pipe(
|
| 98 |
+
prompt,
|
| 99 |
+
width=832, height=1216,
|
| 100 |
+
num_inference_steps=35,
|
| 101 |
+
guidance_scale=5.0,
|
| 102 |
+
).images[0]
|
| 103 |
+
|
| 104 |
+
image.save("juggernaut_xl_v9.png")
|
| 105 |
+
```
|
| 106 |
|
| 107 |
+
For ComfyUI, Forge, InvokeAI, or SwarmUI: download `Juggernaut-XL_v9_RunDiffusionPhoto_v2.safetensors` and drop it into your `models/checkpoints/` (or equivalent) directory.
|
| 108 |
|
| 109 |
+
## Files In This Repo
|
| 110 |
|
| 111 |
+
| File | Purpose |
|
| 112 |
+
| --- | --- |
|
| 113 |
+
| `Juggernaut-XL_v9_RunDiffusionPhoto_v2.safetensors` | Single-file checkpoint for ComfyUI / Forge / InvokeAI / SwarmUI |
|
| 114 |
+
| `unet/`, `text_encoder/`, `text_encoder_2/`, `vae/`, `tokenizer/`, `tokenizer_2/`, `scheduler/`, `model_index.json` | Diffusers-format directory tree (FP16 variant) for `from_pretrained` |
|
| 115 |
|
| 116 |
+
## Looking For Something Newer?
|
| 117 |
|
| 118 |
+
The Juggernaut family has continued to evolve. Match the model to your project:
|
| 119 |
|
| 120 |
+
| Model | Architecture | Best for |
|
| 121 |
+
| --- | --- | --- |
|
| 122 |
+
| **[Juggernaut Z](https://huggingface.co/RunDiffusion/Juggernaut-Z-Image)** | Lumina-Image-2 | Cinematic, presentation-ready output with stronger lighting and atmosphere |
|
| 123 |
+
| **[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 |
|
| 124 |
+
| **[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 |
|
| 125 |
+
| **Juggernaut XL v9** *(this model)* | SDXL 1.0 | Proven SDXL photorealism workhorse with the broadest tooling ecosystem |
|
| 126 |
|
| 127 |
+
## Commercial Use
|
| 128 |
|
| 129 |
+
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)**.
|
| 130 |
|
| 131 |
+
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).
|
| 132 |
|
| 133 |
+
## Credits
|
|
|
|
|
|
|
|
|
|
|
|
|
| 134 |
|
| 135 |
+
Juggernaut XL v9 was created by **[KandooAI](https://twitter.com/Colorblind_Adam)** 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 helping shape the prompting workflow.
|
|
|
|
|
|
|
| 136 |
|
| 137 |
+
## Links
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 138 |
|
| 139 |
+
- π **Run it on RunDiffusion** β [rundiffusion.com/juggernaut-xl](https://www.rundiffusion.com/juggernaut-xl?utm_source=huggingface&utm_medium=model_card&utm_campaign=juggernaut_xl_v9&utm_content=footer_run)
|
| 140 |
+
- π§° **Compare the full Juggernaut lineup** β [rundiffusion.com/juggernaut](https://www.rundiffusion.com/juggernaut?utm_source=huggingface&utm_medium=model_card&utm_campaign=juggernaut_xl_v9&utm_content=footer_lineup)
|
| 141 |
+
- π¨ **Civitai listing** β [civitai.com/models/133005](https://civitai.com/models/133005/juggernaut-xl)
|
| 142 |
+
- π **Base model** β [stabilityai/stable-diffusion-xl-base-1.0](https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0)
|