---
license: other
license_name: fair-ai-public-license-1.0-sd
license_link: https://freedevproject.org/faipl-1.0-sd/
base_model: OnomaAIResearch/Illustrious-xl-early-release-v0
pipeline_tag: text-to-image
tags:
- coreml
- ios
- stable-diffusion-xl
- illustrious
- anime
- localmuse
---

# WAI Illustrious SDXL V17 — Core ML for LocalMuse

A production-oriented Core ML conversion of WAI Illustrious SDXL V17 for
private, on-device 1024×1024 generation in LocalMuse.

## Runtime profile

- Native, non-distilled Illustrious SDXL at 1024×1024.
- 15–30 diffusion steps; LocalMuse defaults to 25.
- DPM-Solver++ Karras, CFG 5–7, batch size one.
- Recommended positive quality tags:
  `masterpiece, best quality, amazing quality`.
- Two 6-bit split UNet components, each below the iOS 1 GiB component limit.
- Model CLIP-L at FP16 and OpenCLIP-bigG at 8-bit.
- Checkpoint VAE decoder and encoder for Text to Image, Transform, and
  LocalMuse Face Detail.
- Requires an iPhone or iPad in the nominal 8 GiB memory class.

The UNet and second text-encoder palettization reduce model storage. They do
not turn V17 into a Lightning, LCM, Turbo, or other reduced-step model.

## Source and reproducibility

Official release: [WAI Illustrious SDXL on Civitai](https://civitai.com/models/827184?modelVersionId=2883731),
model ID `827184`, version ID `2883731`.

Conversion source checkpoint:
[`LyliaEngine/waiIllustriousSDXL_v170`](https://huggingface.co/LyliaEngine/waiIllustriousSDXL_v170/tree/5ef4e2da7173a160ad04aebcaa2fdcd6d20ed792),
revision `5ef4e2da7173a160ad04aebcaa2fdcd6d20ed792`, file
`waiIllustriousSDXL_v170.safetensors`, SHA-256
`f116b0c78ff441467b0cdc8f1936e1ed18ea31e9997c7b132b1b8db533f0bd04`.

The checkpoint contains non-finite values only in CLIP-L's unused final
transformer layer. The converter replaces only those values with the matching
pinned Illustrious base-model layer. SDXL prompt conditioning uses the
preceding hidden state, while pooled conditioning is produced by the exact WAI
second encoder. Exact inputs, revisions, hashes, conversion versions,
component sizes, and validation status are recorded in `PROVENANCE.json`.

## License and attribution

WAI Illustrious SDXL is by WAI0731. The official Civitai release declares the
[Fair AI Public License 1.0-SD](https://freedevproject.org/faipl-1.0-sd/).
The complete license text is included in `LICENSE.md`; its use restrictions
continue to apply to this converted artifact. The Hugging Face source is used
as a pinned transport mirror and its inconsistent repository metadata does not
replace the license declared by the official release.

## Validation status

Checkpoint shapes, all tensors used by inference, compiled component shapes,
and component size limits were verified. The final iPhone runtime test remains
pending and is intentionally not represented as completed in provenance.