File size: 3,391 Bytes
722a672 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 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 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 | ---
license: apache-2.0
language: en
pipeline_tag: text-to-image
tags:
- text-to-image
- diffusion
- chroma
- flux
- gguf
- quantized
- on-device
- ios
- mobile
- apple-silicon
base_model: lodestones/Chroma1-HD
---
# Chroma1-HD — iOS bundle
<p align="center">
<a href="https://github.com/haplollc/Mirage"><img alt="Mirage" src="https://img.shields.io/badge/Runs%20on-Mirage-orange" /></a>
<a href="https://huggingface.co/lodestones/Chroma1-HD"><img alt="Upstream" src="https://img.shields.io/badge/Upstream-lodestones%2FChroma1--HD-blue" /></a>
<img alt="License" src="https://img.shields.io/badge/license-Apache--2.0-lightgrey" />
<img alt="Params" src="https://img.shields.io/badge/params-8.9B-purple" />
</p>
A mobile-friendly bundle of **Chroma1-HD** (8.9B Flux-derived DiT) packaged with T5-XXL + Flux VAE, sized for on-device inference via [**Mirage**](https://github.com/haplollc/Mirage).
Chroma1-HD is the high-resolution flagship variant from [lodestones/Chroma1-HD](https://huggingface.co/lodestones/Chroma1-HD) — fully open weights built on FLUX.1's architecture with significant retraining for general-purpose generation. Excellent at photorealism, illustration, and concept work.
## What's inside
| File | Role | Size |
|---|---|---|
| [`Chroma1-HD-Q4_K_S.gguf`](./Chroma1-HD-Q4_K_S.gguf) | Diffusion transformer — Flux-arch, 8.9B params, Q4_K_S | 5.1 GB |
| [`t5xxl_fp16.safetensors`](./t5xxl_fp16.safetensors) | Text encoder (T5-XXL, fp16) | 9.1 GB |
| [`ae.safetensors`](./ae.safetensors) | VAE (from FLUX.1) | 320 MB |
Total bundle: **~14.5 GB**. Total GPU residency: ~15-16 GB. **iPhone 17 Pro / Air (12 GB) or M-series Mac required.** Older iPhones cannot hold this model.
## Quick start (Mirage)
```swift
import Mirage
let docs = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)[0]
let engine = try Engine(models: ModelFiles(
diffusionModel: docs.appendingPathComponent("Chroma1-HD-Q4_K_S.gguf"),
vae: docs.appendingPathComponent("ae.safetensors"),
textEncoder: docs.appendingPathComponent("t5xxl_fp16.safetensors")
))
let image = try await engine.generate(.init(
prompt: "a Hopper-style oil painting of an empty diner at dawn, soft warm light",
width: 1024, height: 1024,
steps: 28,
cfgScale: 4.0 // Chroma's recommended CFG
))
```
## Provenance
| Component | Upstream | License |
|---|---|---|
| Diffusion transformer | [lodestones/Chroma1-HD](https://huggingface.co/lodestones/Chroma1-HD) | Apache 2.0 |
| GGUF conversion | [silveroxides/Chroma1-HD-GGUF](https://huggingface.co/silveroxides/Chroma1-HD-GGUF) | Apache 2.0 |
| Text encoder | [comfyanonymous/flux_text_encoders](https://huggingface.co/comfyanonymous/flux_text_encoders) (`t5xxl_fp16.safetensors`) | Apache 2.0 |
| VAE | [ffxvs/vae-flux](https://huggingface.co/ffxvs/vae-flux) (re-host of FLUX.1's `ae.safetensors`) | FLUX-1-dev-non-commercial |
## Sizing
- **iPhone 17 Pro / Air (12 GB RAM)** — works but tight; expect ~8 min per 1024² image.
- **iPhone 16 Pro (8 GB RAM)** — does NOT fit. The text encoder alone is 9 GB. Use [`Z-Image-Turbo-iOS`](https://huggingface.co/jc-builds/Z-Image-Turbo-iOS) instead.
- **M2 / M3 Mac** — comfortable, ~4-6 min per 1024² image at 28 steps.
## Built by
[Haplo](https://haplo.app) · [Mirage on GitHub](https://github.com/haplollc/Mirage)
|