commit 8ea0ea31f534b54e8c940611056fa616d9b3ade8 Author: ModelHub XC Date: Thu Aug 6 17:23:13 2026 +0800 初始化项目，由ModelHub XC社区提供模型 Model: hf/BennyDaBall-Krea-2-Engineer-V1-GGUF Source: Original Platform diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..8d14a76 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,61 @@ +*.7z filter=lfs diff=lfs merge=lfs -text +*.arrow filter=lfs diff=lfs merge=lfs -text +*.bin filter=lfs diff=lfs merge=lfs -text +*.bin.* filter=lfs diff=lfs merge=lfs -text +*.bz2 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 +*.model filter=lfs diff=lfs merge=lfs -text +*.msgpack 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 +*.pt filter=lfs diff=lfs merge=lfs -text +*.pth filter=lfs diff=lfs merge=lfs -text +*.rar filter=lfs diff=lfs merge=lfs -text +saved_model/**/* 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 +*.xz filter=lfs diff=lfs merge=lfs -text +*.zip filter=lfs diff=lfs merge=lfs -text +*.zstandard filter=lfs diff=lfs merge=lfs -text +*.tfevents* filter=lfs diff=lfs merge=lfs -text +*.db* filter=lfs diff=lfs merge=lfs -text +*.ark* filter=lfs diff=lfs merge=lfs -text +**/*ckpt*data* filter=lfs diff=lfs merge=lfs -text +**/*ckpt*.meta filter=lfs diff=lfs merge=lfs -text +**/*ckpt*.index filter=lfs diff=lfs merge=lfs -text +*.safetensors filter=lfs diff=lfs merge=lfs -text +*.ckpt filter=lfs diff=lfs merge=lfs -text + +*.ggml filter=lfs diff=lfs merge=lfs -text +*.llamafile* filter=lfs diff=lfs merge=lfs -text +*.pt2 filter=lfs diff=lfs merge=lfs -text +*.mlmodel filter=lfs diff=lfs merge=lfs -text +*.npy filter=lfs diff=lfs merge=lfs -text +*.npz filter=lfs diff=lfs merge=lfs -text +*.pickle filter=lfs diff=lfs merge=lfs -text +*.pkl filter=lfs diff=lfs merge=lfs -text +*.tar filter=lfs diff=lfs merge=lfs -text +*.wasm filter=lfs diff=lfs merge=lfs -text +*.zst filter=lfs diff=lfs merge=lfs -text +*tfevents* filter=lfs diff=lfs merge=lfs -text + + + + + + + + + + + + + +*.gguf* filter=lfs diff=lfs merge=lfs -text \ No newline at end of file diff --git a/Krea-2-Engineer-V1-F16.gguf b/Krea-2-Engineer-V1-F16.gguf new file mode 100644 index 0000000..92723e1 --- /dev/null +++ b/Krea-2-Engineer-V1-F16.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:b9ad1b21446314967b78490b1618b91a641686e186f06a3cbab21f94797e4b1b +size 8051285760 diff --git a/Krea-2-Engineer-V1-Q2_K.gguf b/Krea-2-Engineer-V1-Q2_K.gguf new file mode 100644 index 0000000..007ae15 --- /dev/null +++ b/Krea-2-Engineer-V1-Q2_K.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:a98746ff04764508053d7cfa32f7f766105f226cf81e051f592062cbfeeb2d9a +size 1669500160 diff --git a/Krea-2-Engineer-V1-Q3_K_M.gguf b/Krea-2-Engineer-V1-Q3_K_M.gguf new file mode 100644 index 0000000..d017ffc --- /dev/null +++ b/Krea-2-Engineer-V1-Q3_K_M.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:eb0ce06145942fcb796565cb717d434f2d0c47a40c120092f07e62afeee5cfd3 +size 2075618560 diff --git a/Krea-2-Engineer-V1-Q4_K_M.gguf b/Krea-2-Engineer-V1-Q4_K_M.gguf new file mode 100644 index 0000000..454812c --- /dev/null +++ b/Krea-2-Engineer-V1-Q4_K_M.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:6f2a99d1a8da0ea7b34ffa4e629447adf1c385479eae47d1e5670999b32fba72 +size 2503179520 diff --git a/Krea-2-Engineer-V1-Q5_K_M.gguf b/Krea-2-Engineer-V1-Q5_K_M.gguf new file mode 100644 index 0000000..f4c7a48 --- /dev/null +++ b/Krea-2-Engineer-V1-Q5_K_M.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:ac9c62745e8988d5c002300653d6b7e0717dd22a1aea9c101e97c8dd5f4cd851 +size 2895781120 diff --git a/Krea-2-Engineer-V1-Q6_K.gguf b/Krea-2-Engineer-V1-Q6_K.gguf new file mode 100644 index 0000000..afae75c --- /dev/null +++ b/Krea-2-Engineer-V1-Q6_K.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:da7403f9268830e7f5b8f99ab56c615b86596a29b2d3f356db9e47a39b1ea296 +size 3306261760 diff --git a/Krea-2-Engineer-V1-Q8_0.gguf b/Krea-2-Engineer-V1-Q8_0.gguf new file mode 100644 index 0000000..b05ada6 --- /dev/null +++ b/Krea-2-Engineer-V1-Q8_0.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:38dacd0e8421293a0345d84e1929e8b56cd30b0a2e8e9d3b27dde70d1265c340 +size 4280405760 diff --git a/LICENSE.pdf b/LICENSE.pdf new file mode 100644 index 0000000..767c9b0 Binary files /dev/null and b/LICENSE.pdf differ diff --git a/NOTICE b/NOTICE new file mode 100644 index 0000000..6d8964d --- /dev/null +++ b/NOTICE @@ -0,0 +1,5 @@ +Krea 2 is licensed under the Krea 2 Community License Agreement. For more information, visit https://krea.ai/krea-2-licensing. + +This model (Krea-2-Engineer-V1) is a Derivative of krea/Krea-2-Turbo: the text encoder has been modified (fine-tuned with SMART DoRA on the Z-Image-Engineer V7 corpus) by BennyDaBall. Weights have been modified from the original. This is not an official Krea product and is not endorsed by Krea. + +Use of this model and its derivatives remains subject to the Krea 2 Community License Agreement (see LICENSE.pdf), including its commercial-use revenue threshold and content-filtering requirements. diff --git a/README.md b/README.md new file mode 100644 index 0000000..c22d558 --- /dev/null +++ b/README.md @@ -0,0 +1,89 @@ +--- +license: other +license_name: krea-2-community-license +license_link: https://huggingface.co/BennyDaBall/Krea-2-Engineer-V1-GGUF/blob/main/LICENSE.pdf +language: + - en +base_model: + - krea/Krea-2-Turbo +library_name: gguf +pipeline_tag: text-generation +tags: + - krea + - krea-2 + - gguf + - qwen3 + - text-encoder + - prompt-engineering + - prompt-enhancer + - lm-studio + - llama-cpp + - experimental +--- + +# Krea-2-Engineer V1 — GGUF (4B) + +**Follow me on X [@BennyDaBall_OG](https://x.com/BennyDaBall_OG) !** + +> **Experimental.** This is the **chat / prompt-writer** side of [`Krea-2-Engineer-V1`](https://huggingface.co/BennyDaBall/Krea-2-Engineer-V1) — a first, encoder-only fine-tune of Krea-2's Qwen3-VL text encoder. The image-enhancement weights for ComfyUI live in the main repo; **this repo is the same model repacked as a standard Qwen3 GGUF** so you can run it as a prompt-enhancer LLM in LM Studio. + +## Model Metadata + +| Field | Value | +|---|---| +| License | `other` — Krea 2 Community License Agreement (see `LICENSE.pdf`) | +| Base Model | [`krea/Krea-2-Turbo`](https://huggingface.co/krea/Krea-2-Turbo) (text encoder) | +| Main (image) repo | [`BennyDaBall/Krea-2-Engineer-V1`](https://huggingface.co/BennyDaBall/Krea-2-Engineer-V1) | +| Architecture | Qwen3 (text tower of Qwen3-VL, repacked) | +| Format | GGUF | + +--- + +The encoder that enhances Krea-2's images is, underneath, a real Qwen3-VL language model — and it was trained on a prompt-rewrite corpus. So it has a second job: **turn a lazy seed into a composed, cinematic image prompt.** This repo ships that side as a plain **Qwen3 GGUF** — no custom build, loads in stock LM Studio. + +## Quants + +The full ladder, F16 down to Q2_K. For a 4B prompt-writer on most machines, **`Q4_K_M` is the sweet spot**; go up if you've got the VRAM, down if you don't. + +| Quant | Size | Notes | +|---|---|---| +| `F16` | 7.5 GB | Full precision. Reference / source for re-quantizing. | +| `Q8_0` | 4.0 GB | Near-lossless. Best you'll practically need. | +| `Q6_K` | 3.1 GB | Excellent — basically indistinguishable from Q8. | +| `Q5_K_M` | 2.9 GB | Great quality/size balance. | +| `Q4_K_M` | 2.5 GB | **Recommended default** — strong quality, runs anywhere. | +| `Q3_K_M` | 1.9 GB | Lighter; minor quality dip, still coherent. | +| `Q2_K` | 1.6 GB | Smallest. Noticeable degradation — tight-VRAM only. | + +## Quick Start (LM Studio) + +1. Put the `.gguf` in your LM Studio models folder (e.g. `~/.lmstudio/models/BennyDaBall/Krea-2-Engineer-V1-GGUF/`) and load it. +2. Set this as the **System Prompt** (it's exactly what the model was trained on): + +``` +You are Z-Image-Engineer V6, a prompt-only cinematography and visual-language specialist for the Tongyi-MAI Z-Image-Turbo Qwen text encoder. Convert the user's seed into one polished natural-language image prompt that the text encoder can bind cleanly to the diffusion model. Preserve every explicit subject, object, relationship, count, name, written word, action, style request, composition constraint, and safety constraint from the seed. Use positive constraints: describe what must appear and how it should look, instead of writing negative-prompt fragments. Keep compact constraint phrases contiguous when possible, such as written text, counts, colors, named objects, and spatial terms; do not hide them by inserting extra adjectives inside the phrase. Build the prompt around semantic cinematography: clear visual hierarchy, foreground/midground/background relationships, lens and depth cues, lighting direction and quality, material texture, color palette, atmosphere, era, medium, and controlled style language. Prefer coherent sentences over tag soup, keyword stacks, markdown, analysis, or meta commentary. Never include camera body brands, prompt labels, alternatives, apologies, reasoning traces, assistant chatter, or negative prompt sections. Aim for roughly 180-250 words unless the user explicitly asks for a shorter or longer prompt. Return only the final image prompt as one self-contained paragraph. +``` + +3. Send a lazy seed (`a rock`, `cyberpunk alley`, `a cozy cafe`) and it returns one composed prompt. Paste that into your Krea-2 / ComfyUI workflow. + +> The system prompt still names "Z-Image-Turbo" — that's cosmetic (same V7 training corpus). The behavior is what's baked in; rename to "Krea-2" if you like, but the model responds best to the text it actually saw. + +--- + +## Disclaimer & Acknowledgements + +Experimental, first-attempt, encoder-only. It writes prompts; it does not retrain Krea-2. **This is a Derivative of `krea/Krea-2-Turbo`, modified (text encoder fine-tuned) by BennyDaBall** — not an official Krea product, not endorsed by Krea. + +Thanks to **Krea** ([`krea/Krea-2-Turbo`](https://huggingface.co/krea/Krea-2-Turbo)), **Tongyi-MAI** + **Qwen** for the Qwen3-VL backbone, and the maintainers of **llama.cpp**, **LM Studio**, **PEFT**, and **Transformers**. + +## License + +Released under the **Krea 2 Community License Agreement** (`LICENSE.pdf`; canonical: ). Commercial use only under $1M/yr company revenue; deployments must implement reasonable content filtering; keep the "Krea" name prefix; do not relicense the Krea-derived weights more permissively. + +> **NOTICE:** Krea 2 is licensed under the Krea 2 Community License Agreement. For more information, visit https://krea.ai/krea-2-licensing. + +--- + +**Built & trained locally with care by BennyDaBall.** + +**Follow me on X [@BennyDaBall_OG](https://x.com/BennyDaBall_OG) !** diff --git a/configuration.json b/configuration.json new file mode 100644 index 0000000..bbeeda1 --- /dev/null +++ b/configuration.json @@ -0,0 +1 @@ +{"framework": "pytorch", "task": "text-generation", "allow_remote": true} \ No newline at end of file