Stable Cascade is Stability AI's text-to-image model built on the Würstchen architecture, released as a research preview on February 12, 2024. Its three-stage pipeline generates a compressed representation and reconstructs the final image. Download the weights from Hugging Face and use the official GitHub examples or Diffusers pipeline for local inference. launch card
What are the key facts about Stable Cascade?
| Field | Verified detail |
|---|---|
| Developer | Stability AI. card |
| Released | February 12, 2024, as a research preview. launch |
| Type | Text-to-image diffusion model using a three-stage Würstchen-derived architecture. repo |
| Size or parameters | Stage C: 1B or 3.6B; Stage B: 700M or 1.5B; Stage A: 20M. These are component sizes. repo |
| License and access | Official code uses MIT; model weights have a separate Stability AI Non-Commercial Research Community License. repo |
| Where it runs | Self-hosted through official notebooks or Hugging Face Diffusers pipelines. repo |
How do Stable Cascade's three stages work?
Stable Cascade separates text-conditioned generation from image reconstruction.
Stage C generates the compressed representation; Stages B and A turn that representation into the final image.
Stage A is a VAE, while B and C are diffusion models. repo
The architecture gives researchers separate components to examine. When evaluating a pipeline, identify which stage changes between runs so you can explain whether you are testing generation, reconstruction, or both.
The model card describes encoding a 1024-by-1024 image into a 24-by-24 representation. That compression is the architectural motivation for the project, rather than a measurement of total application memory. card
For practical evaluation, distinguish the size of an intermediate representation from the resources needed to load and execute the full pipeline. Measure the complete setup you intend to use.
Stability AI also supplies notebooks for image variation, image-to-image, and other experiments, plus training material for fine-tuning, ControlNet, and LoRA work. repo
Choose the example closest to the task you want to investigate. If you need variations of an existing image, begin with the variation example instead of attempting to adapt a text-only script without checking its inputs.
The official release includes evaluations of prompt alignment and aesthetic preference.
Read those as the authors' experiments, with their stated models and sampling settings, rather than a universal ranking for every image-generation task. launch
What are Stable Cascade's licensing and model limitations?
Stable Cascade's weight license is separate from the repository's MIT code license.
The supplied weights are covered by non-commercial research terms, so the repository's code badge does not describe unrestricted use of the model. weights-license
The smaller Stage B and Stage C options are separate checkpoints. Stability AI recommends the larger variants for its best results, including improved fine-detail reconstruction from the larger Stage B model. card
Treat that recommendation as a starting point for a resource-quality comparison. Test a smaller combination against your actual acceptance criteria, and preserve examples where the difference matters.
The model card lists incorrectly generated faces or people and lossy autoencoding as limitations. For a portrait or reconstruction experiment, inspect those aspects directly. card
The official implementation documents its own training and inference paths. Use architecture-specific adapters and examples; a file intended for a different model architecture is not evidence of Stable Cascade compatibility. repo
How do you run Stable Cascade locally with Diffusers?
Use the Diffusers combined pipeline for a compact first experiment. The model card documents both the combined interface and separate prior and decoder pipelines. card
Prepare an environment with compatible PyTorch, Diffusers, Transformers, and Accelerate. The card states that using the combined pipeline with torch.bfloat16 requires PyTorch 2.2.0 or later. card
The following example uses the documented combined pipeline and an original prompt. It assumes a compatible CUDA GPU with sufficient memory; CPU offloading is enabled through the pipeline interface. card
import torch
from diffusers import StableCascadeCombinedPipeline
pipe = StableCascadeCombinedPipeline.from_pretrained(
"stabilityai/stable-cascade",
variant="bf16", torch_dtype=torch.bfloat16
)
pipe.enable_model_cpu_offload()
result = pipe(
prompt="A ceramic fox beside a small fern on a wooden desk",
negative_prompt="",
prior_num_inference_steps=20,
num_inference_steps=10,
prior_guidance_scale=3.0,
width=1024, height=1024,
)
result.images[0].save("cascade.png")
The prior and decoder have separate sampling-step arguments. The combined interface handles the connection between them, while the separate pipelines make the intermediate image embeddings explicit. api
Keep the first trial simple:
- Run the documented model combination with a short prompt. Verify that the pipeline finishes and writes an image before adding extra components.
- Save the environment versions, prompt, stage selection, and settings next to the result. Include the command or script needed to repeat it.
- Compare the image against the prompt's concrete requirements. For the example above, inspect the fox, fern, desk, and their spatial relationship.
- Change one stage configuration or generation setting at a time. Keep the prompt unchanged while you investigate that difference.
- Measure memory and elapsed time for the full pipeline. State whether downloads and initial model loading are included in your observation.
If you need the smaller variants, follow the model card's explicit prior_lite and decoder_lite loading example. Record both choices rather than describing the entire setup with one approximate parameter count. card
For a graph-based environment, the ComfyUI guide explains workflow organization.
Verify that a particular workflow loads the stages and files your experiment requires.
How does Stable Cascade compare with SDXL?
| Model | Workflow distinction |
|---|---|
| Stable Cascade | Separate Stage C generation and Stage B/A reconstruction, with component checkpoint choices. repo |
| SDXL | A base text-to-image pipeline, optionally paired with a separate refinement model. sdxl |
Use the SDXL model guide for that alternative's checkpoint ecosystem. Compare models on the same task, while using each model's documented pipeline.
Keep model selection and implementation selection distinct. If two trials use different hardware, precision, or offloading, document those differences before attributing the result to the architecture alone.
What else should you know about Stable Cascade?
Is Stable Cascade based on SDXL?
Stable Cascade is built on the Würstchen architecture and uses three stages. SDXL instead documents a base model that can run alone or with a separate refiner. repo
Is Stable Cascade one 3.6B model?
The 3.6-billion-parameter figure describes Stable Cascade's larger Stage C checkpoint. The full pipeline also uses Stage B and Stage A, whose component sizes are published separately. repo
Are Stable Cascade's weights MIT licensed?
Stable Cascade's code repository uses MIT, while its supplied weights have a separate Stability AI Non-Commercial Research Community License. Read the weight license when evaluating use of the model. repo
Can I run Stable Cascade locally?
Stable Cascade has downloadable weights and local inference examples in its official repository and Diffusers documentation. Its combined Diffusers pipeline supports CPU offloading within a GPU workflow. repo
Sources
- Stability AI release announcement
- Official Stable Cascade model card
- Official code repository and architecture overview
- Stable Cascade model weight license
- Diffusers Stable Cascade pipeline documentation
- Official SDXL model card
Top comments (0)