| --- |
| license: creativeml-openrail-m |
| license_name: tokforge-sd15-ipadapter-bundle |
| tags: |
| - text-to-image |
| - image-to-image |
| - stable-diffusion |
| - ip-adapter |
| - dreamshaper |
| - reference-image |
| - identity |
| - gguf |
| - stable-diffusion-cpp |
| - tokforge |
| base_model: |
| - Lykon/dreamshaper-7 |
| - h94/IP-Adapter |
| pipeline_tag: text-to-image |
| --- |
| |
| # TokForge — SD1.5 IP-Adapter (Reference Identity) bundle |
|
|
| The **reference-identity** image route for the [TokForge](https://tokforge.ai) Android app. |
| Attach a photo of a person, then render **that person** in any scene |
| (*"me as a superhero flying over New York"*). The **plus-face** IP-Adapter transfers |
| the **face only** while the **prompt drives the whole scene**. |
|
|
| This bundle runs on the on-device [`stable-diffusion.cpp`](https://github.com/leejet/stable-diffusion.cpp) |
| GGUF engine (TokForge's IP-Adapter port) on **CPU** and **Adreno OpenCL**. SD1.5 is |
| light enough for any 8 GB+ phone — the broadest-reach identity tier (lighter than the |
| SDXL PhotoMaker tier). |
|
|
| ## Files |
|
|
| | File | Size | License | Contents | |
| |------|------|---------|----------| |
| | `sd15-base-f16.gguf` | ~2.2 GB | CreativeML-OpenRAIL-M | **DreamShaper-7** (SD1.5 realistic finetune) — CLIP text encoder + UNet + VAE in one **f16** GGUF | |
| | `ip-adapter-plus-face_sd15.safetensors` | ~98 MB | Apache-2.0 | IP-Adapter **plus-face** (`h94/IP-Adapter`) — 16-token Resampler + decoupled cross-attn | |
| | `ip_adapter_clip_vision_vith.safetensors` | ~2.5 GB | MIT | OpenCLIP **ViT-H-14** image encoder (the plus-face path needs ViT-H, not bigG) | |
|
|
| `manifest.json` and `MD5SUMS` carry the integrity hashes + render defaults. |
|
|
| ### Why this base, and why f16 (not Q4) |
|
|
| The base is the **standard, non-LCM DreamShaper-7** — the same realistic SD1.5 finetune |
| TokForge ships on its other image tiers. It is converted at **f16** (full precision) so |
| the IP-Adapter's decoupled cross-attention and the face Resampler keep **subject quality** |
| high. A `q4_0`/emaonly base measurably weakens the transferred identity, so this bundle |
| deliberately uses f16. |
|
|
| ### Why plus-face (not the base adapter) |
|
|
| The **base** `ip-adapter_sd15` projects the whole pooled CLIP embedding (4 tokens) → it |
| drags the reference's *entire scene* through (a car selfie came out *"the person in his car"*). |
| The **plus-face** Resampler extracts the **face only** (16 tokens from the ViT-H penultimate |
| hidden state) → identity is preserved while the **prompt** controls the scene. The TokForge |
| sd.cpp IP-Adapter loader auto-detects plus-face by the presence of `image_proj.latents`. |
|
|
| ## How TokForge uses it |
|
|
| In the app: **Image** model picker → download **"SD1.5 IP-Adapter (Reference Identity)"** → |
| attach a face photo as a reference under chat → prompt the scene. The engine is invoked as: |
|
|
| ```bash |
| sd -M img_gen \ |
| -m sd15-base-f16.gguf \ |
| -p "as a superhero flying over New York" \ |
| -n "<strong negative>" \ |
| --clip_vision ip_adapter_clip_vision_vith.safetensors \ |
| --ip-adapter ip-adapter-plus-face_sd15.safetensors \ |
| --ip-adapter-image <your_face.jpg> \ |
| --ip-adapter-scale 0.6 \ |
| --cfg-scale 7.0 --sampling-method euler_a --scheduler discrete \ |
| --steps 30 -H 512 -W 512 |
| ``` |
|
|
| ### Recommended render settings |
|
|
| | Setting | Value | |
| |---------|-------| |
| | sampler | `euler_a` | |
| | scheduler | `discrete` | |
| | steps | `30` (full quality; fewer = faster) | |
| | cfg-scale | `7.0` | |
| | ip-adapter-scale | `0.6` (≈0.5–0.6 keeps the scene with recognizable identity; ~0.8 reconstructs the reference) | |
| | resolution | `512×512` (SD1.5 native) | |
|
|
| ## Licenses |
|
|
| This is an aggregate of three independently-licensed components — each retains its own license: |
|
|
| - **DreamShaper-7 base** (`sd15-base-f16.gguf`) — **CreativeML-OpenRAIL-M** ([Lykon/dreamshaper-7](https://huggingface.co/Lykon/dreamshaper-7)). Use must comply with the OpenRAIL-M use-based restrictions. |
| - **IP-Adapter plus-face** (`ip-adapter-plus-face_sd15.safetensors`) — **Apache-2.0** ([h94/IP-Adapter](https://huggingface.co/h94/IP-Adapter)). |
| - **OpenCLIP ViT-H-14 image encoder** (`ip_adapter_clip_vision_vith.safetensors`) — **MIT** (OpenCLIP / LAION ViT-H-14). |
|
|
| > The non-commercial **IP-Adapter-FaceID** / InsightFace path is **NOT** used here — only the |
| > Apache-2.0 base + plus-face adapters from `h94/IP-Adapter`. |
|
|
| ## Provenance |
|
|
| - Base converted from `Lykon/dreamshaper-7` (diffusers) to a single f16 GGUF via the TokForge |
| `stable-diffusion.cpp` convert path (`-M convert --type f16`). |
| - Adapter + image encoder copied verbatim from `h94/IP-Adapter` (`models/ip-adapter-plus-face_sd15.safetensors`, |
| `models/image_encoder/model.safetensors`). |
|
|
