Publish GemmAnima adapter bundle v0.1

.gitattributes

@@ -1,35 +1,3 @@
-*.7z filter=lfs diff=lfs merge=lfs -text
-*.arrow filter=lfs diff=lfs merge=lfs -text
-*.bin filter=lfs diff=lfs merge=lfs -text
-*.bz2 filter=lfs diff=lfs merge=lfs -text
-*.ckpt filter=lfs diff=lfs merge=lfs -text
-*.ftz filter=lfs diff=lfs merge=lfs -text
-*.gz filter=lfs diff=lfs merge=lfs -text
-*.h5 filter=lfs diff=lfs merge=lfs -text
-*.joblib filter=lfs diff=lfs merge=lfs -text
-*.lfs.* filter=lfs diff=lfs merge=lfs -text
-*.mlmodel filter=lfs diff=lfs merge=lfs -text
-*.model filter=lfs diff=lfs merge=lfs -text
-*.msgpack filter=lfs diff=lfs merge=lfs -text
-*.npy filter=lfs diff=lfs merge=lfs -text
-*.npz filter=lfs diff=lfs merge=lfs -text
-*.onnx filter=lfs diff=lfs merge=lfs -text
-*.ot filter=lfs diff=lfs merge=lfs -text
-*.parquet filter=lfs diff=lfs merge=lfs -text
-*.pb filter=lfs diff=lfs merge=lfs -text
-*.pickle filter=lfs diff=lfs merge=lfs -text
-*.pkl filter=lfs diff=lfs merge=lfs -text
-*.pt filter=lfs diff=lfs merge=lfs -text
-*.pth filter=lfs diff=lfs merge=lfs -text
-*.rar filter=lfs diff=lfs merge=lfs -text
+*.gguf filter=lfs diff=lfs merge=lfs -text
 *.safetensors filter=lfs diff=lfs merge=lfs -text
-saved_model/**/* filter=lfs diff=lfs merge=lfs -text
-*.tar.* filter=lfs diff=lfs merge=lfs -text
-*.tar filter=lfs diff=lfs merge=lfs -text
-*.tflite filter=lfs diff=lfs merge=lfs -text
-*.tgz filter=lfs diff=lfs merge=lfs -text
-*.wasm filter=lfs diff=lfs merge=lfs -text
-*.xz filter=lfs diff=lfs merge=lfs -text
-*.zip filter=lfs diff=lfs merge=lfs -text
-*.zst filter=lfs diff=lfs merge=lfs -text
-*tfevents* filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text

LICENSE_NOTICES.md

@@ -0,0 +1,66 @@
+# GemmAnima License Notices
+
+This notice is for the GemmAnima adapter/checkpoint bundle. It is not a legal
+opinion. Verify upstream terms before any public or commercial release.
+
+## Bundle Scope
+
+This repository should contain only GemmAnima-owned or GemmAnima-adapted files:
+
+- Gemma Core LoRA adapters and vision projector
+- HiddenStage Bridge planner adapter, vision embedding, and bridge checkpoint
+- Runtime metadata and documentation
+
+Original base model weights are external dependencies. They should be downloaded
+from their original model pages at first run and should not be mirrored in this
+repository unless redistribution permission is explicitly documented.
+
+## Source License Summary
+
+| Component | Source | License / notice |
+| --- | --- | --- |
+| Gemma Core base GGUF | `mradermacher/gemma-4-E2B-it-heretic-ara-custom-GGUF` | `apache-2.0` according to the upstream Hugging Face model metadata |
+| Anima diffusion model | `circlestone-labs/Anima` | CircleStone Labs Non-Commercial License according to the upstream model page |
+| Anima VAE file | `circlestone-labs/Anima` | Follow the upstream Anima page and the original VAE/model notices |
+| GemmAnima adapters/checkpoints | GemmAnima adapter bundle | `other` until a final project license is selected; use is also constrained by upstream base model licenses |
+
+The Anima model page states that Anima is licensed under the CircleStone Labs
+Non-Commercial License, is usable only for non-commercial purposes, and is a
+Derivative Model of NVIDIA Cosmos-Predict2-2B-Text2Image subject to the NVIDIA
+Open Model License Agreement where applicable.
+
+## Practical Release Rule
+
+For the adapter bundle, use the most restrictive applicable terms across the
+loaded stack:
+
+1. GemmAnima adapter/checkpoint bundle notice
+2. Gemma/GGUF upstream license and source model terms
+3. Anima upstream license
+4. NVIDIA license terms referenced by the Anima upstream page
+5. Dataset/source policy for any training data used to create the adapter
+
+Until a formal review is complete, treat the public adapter release as
+non-commercial/restricted-use only. Do not present it as production-ready,
+commercial-ready, or as relicensing any upstream base model.
+
+## Required Attribution in Model Card
+
+Before public release, the model card should include:
+
+- Original Gemma/GGUF repository link and license
+- Original Anima repository link and non-commercial license notice
+- NVIDIA Open Model License reference as required by Anima
+- Statement that original base weights are not mirrored here
+- Statement that GemmAnima adapters do not relicense upstream base models
+- Dataset/source policy summary for adapter training data
+
+## Files Not To Upload Here
+
+- `gemma-4-E2B-it-heretic-ara-custom.Q4_K_M.gguf`
+- `anima-base-v1.0.safetensors`
+- `qwen_image_vae.safetensors`
+- Anima text encoder weights
+
+These files should be downloaded from their original pages by the first-run
+asset downloader.

README.md

@@ -0,0 +1,253 @@
+---
+language:
+- en
+- ko
+tags:
+- gemma
+- gguf
+- lora
+- multimodal
+- image-generation
+- anime
+- danbooru
+- local-runtime
+license: other
+---
+
+# GemmAnima Adapter Bundle
+
+GemmAnima is a local multimodal adapter bundle that connects a Gemma/TIPO-style
+language and vision-tagging core to an Anima image-generation core through a
+HiddenStage bridge.
+
+This repository is intended for GemmAnima-owned adapters, projectors, bridge
+checkpoints, and runtime metadata for the standalone GemmAnima app. It is not a
+single monolithic model file, and it should not mirror upstream base model
+weights.
+
+## Status
+
+- Release status: v0.1 public adapter/checkpoint release
+- Safety status: not safety-rated
+- Evaluation status: partial smoke and bridge checks only
+- License status: adapter/checkpoint bundle with upstream dependency licenses;
+  see `LICENSE_NOTICES.md`
+- Visibility: public adapter-only repository; upstream base model weights are
+  not mirrored here
+
+Do not treat this as a promoted production model without additional evaluation.
+Do not treat this adapter bundle as relicensing any upstream base model.
+
+## Model Parts
+
+This repository should contain only the files produced or adapted by the
+GemmAnima project. Original base models should be downloaded from their original
+distribution pages and placed locally according to the standalone app
+configuration.
+
+### 1. Gemma Core
+
+The Gemma Core handles chat, language-harness behavior, canonical English
+Danbooru tag output, and vision tagger language behavior.
+
+GemmAnima files:
+
+| File | Role |
+| --- | --- |
+| `text-adapter-model-f16.gguf` | Text/chat LoRA adapter |
+| `vision-tagger-adapter-model-f16.gguf` | Vision/tagger LoRA adapter |
+| `gemma4-tipo-vision.mmproj-f16.gguf` | Vision projector |
+
+External requirement:
+
+| File | How to obtain |
+| --- | --- |
+| `gemma-4-E2B-it-heretic-ara-custom.Q4_K_M.gguf` | Download from `mradermacher/gemma-4-E2B-it-heretic-ara-custom-GGUF`; do not mirror it here unless redistribution is explicitly permitted and intentionally chosen. |
+
+Upstream license metadata for the GGUF page currently reports `apache-2.0`.
+
+The preferred runtime shape is an upstream base GGUF loaded with GemmAnima
+task-specific LoRA adapters through llama.cpp `--lora`. Older fully merged GGUFs
+are not the preferred packaging shape.
+
+### 2. Anima Image Core
+
+The Anima Image Core handles diffusion sampling and VAE decoding.
+
+GemmAnima files:
+
+This repository does not need to contain Anima Image Core base weights.
+
+External requirements:
+
+| File | Role |
+| --- | --- |
+| `split_files/diffusion_models/anima-base-v1.0.safetensors` | Download from `circlestone-labs/Anima` |
+| `split_files/vae/qwen_image_vae.safetensors` | Download from `circlestone-labs/Anima` |
+
+The upstream Anima page currently reports
+`circlestone-labs-non-commercial-license` and states that Anima is also subject
+to the NVIDIA Open Model License Agreement where applicable because it is a
+derivative of NVIDIA Cosmos-Predict2-2B-Text2Image.
+
+Anima text encoder weights are not part of the required standalone runtime. The
+current in-process renderer uses Anima-compatible tokenizer metadata
+(`t5xxl_ids` and `t5xxl_weights`) for conditioning shape compatibility, not the
+Anima text encoder weight file.
+
+Supported generation controls in the standalone app:
+
+| Type | Supported values |
+| --- | --- |
+| Sampler | `euler`, `euler_ancestral`, `dpmpp_2m`, `dpmpp_2m_sde_gpu` |
+| Scheduler | `normal`, `karras`, `sgm_uniform` |
+| Resolution presets | `1024x1024`, `832x1216`, `768x1344`, custom |
+
+### 3. HiddenStage Bridge
+
+The HiddenStage Bridge connects Gemma hidden-state features to Anima-compatible
+conditioning.
+
+GemmAnima files:
+
+| File | Role |
+| --- | --- |
+| `hiddenstage-planner-adapter.safetensors` | Planner LoRA adapter |
+| `hiddenstage-planner-embed-vision.pt` | Planner vision embedding |
+| `kv_proj_hiddenstage_planner_v2.pt` | HiddenStage bridge checkpoint |
+
+Current local bridge metadata:
+
+| Metric | Value |
+| --- | --- |
+| Bridge validation MSE | `0.001104317136865575` |
+| Bridge gate | passed |
+| Planner eval loss | `1.0061092711985111` |
+| Planner eval threshold | `1.5` |
+
+These are engineering gate metrics, not a full end-user quality evaluation.
+
+## Approximate Size
+
+This adapter repository should be much smaller than the full local runtime
+because original base weights are expected to come from their original pages:
+
+| Part | Approximate upload size |
+| --- | ---: |
+| Gemma Core adapters/projector | ~1.03 GB |
+| HiddenStage Bridge | ~0.18 GB |
+| Anima Image Core base weights | not uploaded here |
+| Total uploaded here | ~1.21 GB |
+
+For local runtime planning, the full standalone runtime is about 9 GB in decimal
+units after the user downloads the external base weights separately:
+
+| Part | Approximate size |
+| --- | ---: |
+| Gemma Core | ~4.51 GB |
+| Anima Image Core | ~4.44 GB |
+| HiddenStage Bridge | ~0.18 GB |
+| Total | ~9.12 GB |
+
+Exact size depends on final filenames and whether source adapters or
+compatibility reference models are included.
+
+## Intended Use
+
+This bundle is intended for:
+
+- Local GemmAnima app runtime testing
+- Korean or English chat with an explicit language harness
+- Canonical English Danbooru tag output for tag requests
+- Chat-driven image-generation request planning
+- Anima image rendering through the app-controlled preset system
+
+For tag requests, output tags should remain canonical English Danbooru tags even
+when the user-facing chat language is Korean.
+
+## Out of Scope
+
+This bundle is not intended as:
+
+- A general-purpose safety-filtered assistant
+- A fully evaluated public image-generation model
+- A replacement for downloading or licensing upstream base components
+- A license override for Gemma, Anima, NVIDIA Cosmos, or any source dataset
+- A guarantee of pose, anatomy, text rendering, or prompt fidelity
+
+## Known Limitations
+
+- Safety and content behavior have not been fully evaluated.
+- Pose understanding remains an active improvement area.
+- Some broad ComfyUI samplers were intentionally not exposed because they were
+  not part of the app-supported smoke-tested subset.
+- The app currently owns a curated sampler/scheduler contract rather than
+  exposing every option from ComfyUI.
+- Checkpoint-only re-learning outputs should not be promoted without separate
+  evaluation.
+- Base model files are external dependencies and should remain linked to their
+  original distribution pages.
+
+## Runtime Notes
+
+Recommended local runtime:
+
+- Windows + PowerShell
+- RTX 4070 Ti SUPER as the primary PyTorch/rendering GPU
+- llama.cpp CUDA build for Gemma Core inference
+- GemmAnima standalone app for orchestration
+
+Keep RTX 5060 out of PyTorch cache/training paths unless explicitly re-enabled
+with a compatible PyTorch build.
+
+## Release Checklist
+
+For the v0.1 public adapter-only release:
+
+- Verify upstream licenses for Gemma, Anima, VAE, and all GemmAnima adapters.
+- Confirm this repository remains adapter/checkpoint-only unless explicit
+  redistribution permission is documented.
+- Add upstream download links for the required original model pages.
+- Include `LICENSE_NOTICES.md` in the repository.
+- Add final SHA256 checksums for each uploaded file.
+
+Still required before promotion:
+
+- Run and publish a small reproducible inference smoke.
+- Run a safety and content-policy review.
+- Add representative example outputs only after evaluation.
+
+## Example File Layout
+
+```text
+.
+|-- README.md
+|-- LICENSE_NOTICES.md
+|-- model_sources.json
+|-- adapter_manifest_v0.1.json
+|-- gemma_core/
+|   |-- text-adapter-model-f16.gguf
+|   |-- vision-tagger-adapter-model-f16.gguf
+|   `-- gemma4-tipo-vision.mmproj-f16.gguf
+`-- hiddenstage_bridge/
+    |-- hiddenstage-planner-adapter.safetensors
+    |-- hiddenstage-planner-embed-vision.pt
+    `-- kv_proj_hiddenstage_planner_v2.pt
+```
+
+External base weights should be downloaded separately from their original model
+pages and referenced by the local GemmAnima app configuration.
+
+The standalone app download plan uses:
+
+```powershell
+python -m gemmanima.cli model-download-plan --json
+python -m gemmanima.cli ensure-model-assets --json
+```
+
+## Citation and Attribution
+
+This is a composite adapter/checkpoint bundle. It does not relicense upstream
+base models. Add upstream citations, original download links, and license
+notices for the base model, image model, VAE, NVIDIA dependency, and any
+training datasets before a public release.

VERSION

@@ -0,0 +1 @@
+v0.1

adapter_manifest_v0.1.json

@@ -0,0 +1,52 @@
+{
+    "name":  "GemmAnima adapter bundle",
+    "version":  "v0.1",
+    "repo_id":  "raspie/gemmanima-adapter-bundle",
+    "release_type":  "public adapter-only",
+    "excludes_base_weights":  true,
+    "created_at_utc":  "2026-06-01T14:51:18.6843277Z",
+    "files":  [
+                  {
+                      "path":  "gemma_core/text-adapter-model-f16.gguf",
+                      "role":  "Gemma Core text/chat LoRA adapter",
+                      "bytes":  48345088,
+                      "sha256":  "c26b150bee789331bf02c7069f34a1242e1ff861d65e67eb6aacb79414d2bd6f",
+                      "source_path":  "D:\\Projects\\training\\out\\lora\\adapter_model.f16.gguf"
+                  },
+                  {
+                      "path":  "gemma_core/vision-tagger-adapter-model-f16.gguf",
+                      "role":  "Gemma Core vision/tagger LoRA adapter",
+                      "bytes":  48345088,
+                      "sha256":  "2c87cc13a3896d8665e81c202f17835aa3006d74c3a532d80b72efaf2b3b9f4c",
+                      "source_path":  "D:\\Projects\\training\\out\\gemmanima_v4_vision_tagger\\adapter_model.f16.gguf"
+                  },
+                  {
+                      "path":  "gemma_core/gemma4-tipo-vision.mmproj-f16.gguf",
+                      "role":  "Gemma Core vision projector",
+                      "bytes":  985653600,
+                      "sha256":  "5b31d9252fa6c2ea767ab12f90a868e69eaaecd71dc3e10816ca167f87ebc420",
+                      "source_path":  "D:\\Projects\\training\\out\\_completed\\gemma4-tipo-vision.mmproj-f16.gguf"
+                  },
+                  {
+                      "path":  "hiddenstage_bridge/hiddenstage-planner-adapter.safetensors",
+                      "role":  "HiddenStage planner adapter",
+                      "bytes":  96693360,
+                      "sha256":  "73e6dca4a6b286f2ea4a2d23a708ff939ef45fef09919467d35b337b05000bec",
+                      "source_path":  "D:\\Projects\\training\\out\\hiddenstage_multimodal_planner_anima_v2\\adapter_model.safetensors"
+                  },
+                  {
+                      "path":  "hiddenstage_bridge/hiddenstage-planner-embed-vision.pt",
+                      "role":  "HiddenStage planner vision embedding",
+                      "bytes":  4720396,
+                      "sha256":  "3f6d0d3d51f61599c1a201ceac378fcd713e9eb16da457414b87e0b244a85391",
+                      "source_path":  "D:\\Projects\\training\\out\\hiddenstage_multimodal_planner_anima_v2\\embed_vision.pt"
+                  },
+                  {
+                      "path":  "hiddenstage_bridge/kv_proj_hiddenstage_planner_v2.pt",
+                      "role":  "HiddenStage bridge checkpoint",
+                      "bytes":  75502813,
+                      "sha256":  "efecbc91072c3a4d41ddc0d4d399d13ed0bfa0946b10a39d0b80bbd2144666da",
+                      "source_path":  "E:\\anima_gemma_swap\\kv_proj_hiddenstage_planner_v2.pt"
+                  }
+              ]
+}

gemma_core/gemma4-tipo-vision.mmproj-f16.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5b31d9252fa6c2ea767ab12f90a868e69eaaecd71dc3e10816ca167f87ebc420
+size 985653600

gemma_core/text-adapter-model-f16.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c26b150bee789331bf02c7069f34a1242e1ff861d65e67eb6aacb79414d2bd6f
+size 48345088

gemma_core/vision-tagger-adapter-model-f16.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:2c87cc13a3896d8665e81c202f17835aa3006d74c3a532d80b72efaf2b3b9f4c
+size 48345088

hiddenstage_bridge/hiddenstage-planner-adapter.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:73e6dca4a6b286f2ea4a2d23a708ff939ef45fef09919467d35b337b05000bec
+size 96693360

hiddenstage_bridge/hiddenstage-planner-embed-vision.pt

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:3f6d0d3d51f61599c1a201ceac378fcd713e9eb16da457414b87e0b244a85391
+size 4720396

hiddenstage_bridge/kv_proj_hiddenstage_planner_v2.pt

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:efecbc91072c3a4d41ddc0d4d399d13ed0bfa0946b10a39d0b80bbd2144666da
+size 75502813

model_sources.json

@@ -0,0 +1,62 @@
+{
+  "model_root_default": "%LOCALAPPDATA%\\GemmAnima\\models",
+  "model_root_override_env": "GEMMANIMA_MODEL_ROOT",
+  "adapter_repo_override_env": "GEMMANIMA_ADAPTER_REPO",
+  "sources": {
+    "gemma_core.shared_base_gguf": {
+      "origin": "original_model_page",
+      "repo_id": "mradermacher/gemma-4-E2B-it-heretic-ara-custom-GGUF",
+      "filename": "gemma-4-E2B-it-heretic-ara-custom.Q4_K_M.gguf",
+      "license_id": "apache-2.0"
+    },
+    "gemma_core.text_lora": {
+      "origin": "gemmanima_adapter_bundle",
+      "repo_id": "raspie/gemmanima-adapter-bundle",
+      "filename": "gemma_core/text-adapter-model-f16.gguf",
+      "license_id": "other"
+    },
+    "gemma_core.vision_lora": {
+      "origin": "gemmanima_adapter_bundle",
+      "repo_id": "raspie/gemmanima-adapter-bundle",
+      "filename": "gemma_core/vision-tagger-adapter-model-f16.gguf",
+      "license_id": "other"
+    },
+    "gemma_core.vision_mmproj": {
+      "origin": "gemmanima_adapter_bundle",
+      "repo_id": "raspie/gemmanima-adapter-bundle",
+      "filename": "gemma_core/gemma4-tipo-vision.mmproj-f16.gguf",
+      "license_id": "other"
+    },
+    "anima_image_core.diffusion_model": {
+      "origin": "original_model_page",
+      "repo_id": "circlestone-labs/Anima",
+      "filename": "split_files/diffusion_models/anima-base-v1.0.safetensors",
+      "license_id": "circlestone-labs-non-commercial-license",
+      "license_note": "The upstream Anima page also states that the model is a derivative of NVIDIA Cosmos-Predict2-2B-Text2Image and is subject to the NVIDIA Open Model License Agreement where applicable."
+    },
+    "anima_image_core.vae": {
+      "origin": "original_model_page",
+      "repo_id": "circlestone-labs/Anima",
+      "filename": "split_files/vae/qwen_image_vae.safetensors",
+      "license_id": "circlestone-labs-non-commercial-license"
+    },
+    "hiddenstage_bridge.planner_adapter": {
+      "origin": "gemmanima_adapter_bundle",
+      "repo_id": "raspie/gemmanima-adapter-bundle",
+      "filename": "hiddenstage_bridge/hiddenstage-planner-adapter.safetensors",
+      "license_id": "other"
+    },
+    "hiddenstage_bridge.planner_vision_embedding": {
+      "origin": "gemmanima_adapter_bundle",
+      "repo_id": "raspie/gemmanima-adapter-bundle",
+      "filename": "hiddenstage_bridge/hiddenstage-planner-embed-vision.pt",
+      "license_id": "other"
+    },
+    "hiddenstage_bridge.bridge_checkpoint": {
+      "origin": "gemmanima_adapter_bundle",
+      "repo_id": "raspie/gemmanima-adapter-bundle",
+      "filename": "hiddenstage_bridge/kv_proj_hiddenstage_planner_v2.pt",
+      "license_id": "other"
+    }
+  }
+}