TokForge-epiCRealism-CoreML-6bit

Published by TokForge for on-device inference.

TokForge

• Website: https://tokforge.ai
• Discord: https://discord.gg/Acv3CBtfVm
• Google Play: https://play.google.com/store/apps/details?id=dev.tokforge
• iOS TestFlight: https://testflight.apple.com/join/jnufjzRr

Runs on-device in the TokForge app.

TokForge: epiCRealism · CoreML 6-bit (Apple Neural Engine)

A 6-bit palettized Apple CoreML conversion of epiCRealism (emilianJR/epiCRealism, an SD-1.5 cinematic photoreal finetune with 1M+ downloads), built for on-device image generation in the TokForge iOS app. Converted with Apple ml-stable-diffusion (torch2coreml) using SPLIT_EINSUM_V2 attention and --quantize-nbits 6 (6-bit palettized weights), so it compiles fast on the Apple Neural Engine.

Part of the TokForge iOS · CoreML Image Models collection.

Files

The Resources/ tree holds the compiled .mlmodelc models plus the CLIP vocab.json + merges.txt, the exact layout Apple's StableDiffusionPipeline (and the TokForge installer) loads.

Recommended render settings

attention:    split_einsum_v2 (Apple Neural Engine)
compute:      .cpuAndNeuralEngine  (palettized -> fast ANE compile)
steps:        20-30  (epiCRealism cinematic-portrait range)
cfg-scale:    7.0
resolution:   512x512  (SD-1.5 native; baked into the compiled model)

How this was built

1. Loaded emilianJR/epiCRealism (SD-1.5 diffusers format).
2. Converted UNet + text encoder + VAE decoder + VAE encoder to CoreML with Apple ml-stable-diffusion python_coreml_stable_diffusion.torch2coreml, --attention-implementation SPLIT_EINSUM_V2.
3. Applied 6-bit palettization (--quantize-nbits 6).
4. Bundled the compiled resources for the Swift CLI (--bundle-resources-for-swift-cli).

Conversion peaked at ~9.8 GB RAM (no --chunk-unet needed). Runs on iOS 17+ (6-bit palettized weights require the iOS-17 ANE runtime); on iOS-16 the app falls back to an FP16 model.

License & attribution

• License: CreativeML OpenRAIL-M, inherited from epiCRealism / Stable Diffusion 1.5. Use is subject to the OpenRAIL-M restrictions.
• Base model: epiCRealism by epinikion (Hugging Face copy by emilianJR): https://huggingface.co/emilianJR/epiCRealism. All credit for the model weights is epinikion's.
• Conversion tooling: Apple ml-stable-diffusion: https://github.com/apple/ml-stable-diffusion (6-bit palettization, SPLIT_EINSUM_V2 attention).
• Built on top of Stable Diffusion 1.5 (Runway/CompVis/Stability).

This repository is a redistribution for on-device use, a format conversion (PyTorch -> CoreML) and 6-bit palettization of epinikion's epiCRealism. No weights were retrained. The original OpenRAIL-M terms and attribution requirements propagate to this conversion and any images generated with it. No additional restrictions are imposed by this repackaging.

Credits

• epiCRealism by epinikion (Civitai, Hugging Face). Used under the CreativeML OpenRAIL-M license and the creator's Civitai terms. epinikion's Civitai terms: credit required, no selling the model or merges of it.
• Stable Diffusion v1.5 by Runway and CompVis (Hugging Face). Used under the CreativeML OpenRAIL-M license.
• Converted to Core ML with ml-stable-diffusion by Apple (MIT).