Update README.md

README.md

@@ -1,5 +1,50 @@
----
-license: other
-license_name: circlestone-labs-non-commercial-license
-license_link: https://huggingface.co/circlestone-labs/Anima/blob/main/LICENSE.txt
----
+---
+license: other
+license_name: circlestone-labs-non-commercial-license
+license_link: https://huggingface.co/circlestone-labs/Anima/blob/main/LICENSE.txt
+tags:
+  - stable-diffusion.cpp
+  - gguf
+  - anima
+  - image-generation
+  - quantized
+---
+
+# Anima - GGUF Quantized Models
+
+These are GGUF quantized versions of the [Anima](https://huggingface.co/circlestone-labs/Anima) model, highly optimized for local inference on low-RAM devices (like smartphones via Termux or older PCs) using `stable-diffusion.cpp`.
+
+⚠️ **Important Note:** Support for Anima is currently **experimental** and has not yet been merged into the `main` branch of `stable-diffusion.cpp`. To use these models, you must compile the engine using the specific fork/branch from [PR #1296](https://github.com/leejet/stable-diffusion.cpp/pull/1296).
+
+## 📦 Available Formats
+
+* **`anima-preview-Q4_K.gguf` :** Smallest footprint. Best for Low RAM.
+* **`anima-preview-Q5_K.gguf` :** Balanced size and quality.
+* **`anima-preview-Q6_K.gguf` :** High quality, requires slightly more memory.
+
+## 🚀 How to Use
+
+Ensure you have built `stable-diffusion.cpp` from the experimental Anima branch.
+
+```bash
+./bin/sd-cli \
+    --diffusion-model /path/to/anima-preview-Q4_K.gguf \
+    --llm /path/to/qwen_3_06b_base.safetensors \
+    --vae /path/to/qwen_image_vae.safetensors \
+    --vae-tiling \
+    --steps 30 \
+    --cfg-scale 4 \
+    -W 1024 -H 1024 \
+    -p "a cute blue cat in a park" \
+    -o output.png
+
+```
+
+*(Note: The `--vae-tiling` flag is highly recommended to prevent out-of-memory errors during the image decoding phase).*
+
+## 🙌 Acknowledgments & Credits
+
+* **Original Model:** [circlestone-labs](https://huggingface.co/circlestone-labs).
+* **Engine:** The [stable-diffusion.cpp](https://github.com/leejet/stable-diffusion.cpp) project for making local AI accessible.
+* **Implementation:** Special thanks to GitHub contributor [@rmatif](https://github.com/rmatif) for developing Anima support in [PR #1296](https://github.com/leejet/stable-diffusion.cpp/pull/1296).
+* **License:** These files are subject to the **circlestone-labs-non-commercial-license**.