Normalize model card line endings
Browse files
README.md
CHANGED
|
@@ -1,68 +1,68 @@
|
|
| 1 |
-
---
|
| 2 |
-
license: other
|
| 3 |
-
license_name: bluepixel-component-licenses
|
| 4 |
-
license_link: https://huggingface.co/t8star/BluePixel-Comfy/blob/main/LICENSE.md
|
| 5 |
-
language:
|
| 6 |
-
- en
|
| 7 |
-
- zh
|
| 8 |
-
base_model: openvivo/BluePixel-Turbo
|
| 9 |
-
base_model_relation: quantized
|
| 10 |
-
pipeline_tag: image-to-image
|
| 11 |
-
library_name: comfyui
|
| 12 |
-
tags:
|
| 13 |
-
- comfyui
|
| 14 |
-
- bluepixel
|
| 15 |
-
- image-editing
|
| 16 |
-
- int8
|
| 17 |
-
- convrot
|
| 18 |
-
- 4k
|
| 19 |
-
- safetensors
|
| 20 |
-
---
|
| 21 |
-
|
| 22 |
-
# BluePixel for ComfyUI
|
| 23 |
-
|
| 24 |
-
**English** | [简体中文](README_CN.md)
|
| 25 |
-
|
| 26 |
-
Three standalone components converted from [openvivo/BluePixel-Turbo](https://huggingface.co/openvivo/BluePixel-Turbo) for native ComfyUI image editing. Use them with [ComfyUI BluePixel T8](https://github.com/T8mars/Comfyui-BluePixel-T8), which provides the loaders and eight editable canvas workflows.
|
| 27 |
-
|
| 28 |
-
## Download
|
| 29 |
-
|
| 30 |
-
Place each file in the matching folder under your ComfyUI installation. Total download: **28.19 GB** (decimal).
|
| 31 |
-
|
| 32 |
-
| Component | File | ComfyUI folder | Size |
|
| 33 |
-
| --- | --- | --- | --- |
|
| 34 |
-
| Diffusion · INT8 ConvRot | [bluepixel_turbo_int8_convrot.safetensors](diffusion_models/bluepixel_turbo_int8_convrot.safetensors) | `models/diffusion_models/` | 9.09 GB |
|
| 35 |
-
| Qwen3-8B · BF16 | [bluepixel_qwen3_8b_original.safetensors](text_encoders/bluepixel_qwen3_8b_original.safetensors) | `models/text_encoders/` | 16.39 GB |
|
| 36 |
-
| DCAE-F64 · FP32 | [bluepixel_dcae_f64.safetensors](vae/bluepixel_dcae_f64.safetensors) | `models/vae/` | 2.71 GB |
|
| 37 |
-
|
| 38 |
-
Each component is one Safetensors file. The text encoder includes its tokenizer. File sizes and SHA256 hashes are recorded in [checksums.json](checksums.json); adjacent manifests document conversion mappings and source hashes.
|
| 39 |
-
|
| 40 |
-
## Quick start
|
| 41 |
-
|
| 42 |
-
1. Install **BluePixel T8** through ComfyUI Manager, or follow the [manual installation guide](https://github.com/T8mars/Comfyui-BluePixel-T8/blob/main/README_EN.md#installation).
|
| 43 |
-
2. Download all three components above and restart ComfyUI.
|
| 44 |
-
3. Download the JSON for a [1K preview or 4K editing workflow](https://github.com/T8mars/Comfyui-BluePixel-T8/tree/main/workflows), select the files and input image, and enter an editing instruction. Open the local canvas JSON with **Ctrl+O**, or drop it onto ComfyUI.
|
| 45 |
-
4. Start with **4 steps, CFG 3**. The 4K example outputs 4096×4096.
|
| 46 |
-
|
| 47 |
-
Requires Python 3.10+, ComfyUI 0.43.0+, Diffusers 0.40+ and a compatible PyTorch / comfy-kitchen CUDA environment. Use the package's three **BluePixel Loader** nodes, then connect their standard outputs to ComfyUI sampling and VAE nodes. DCAE-F64 has 64× spatial compression and cannot be replaced by an ordinary Flux2 VAE.
|
| 48 |
-
|
| 49 |
-
## Conversion and validation
|
| 50 |
-
|
| 51 |
-
- Source weights: `openvivo/BluePixel-Turbo` at `e9c7a641a4bcd9851eef50c1ce9b07fa44f6044c`.
|
| 52 |
-
- Diffusion weights are mapped to the native Flux2/Klein layout and quantized with INT8 ConvRot. Quantization is lossy; this is not a BF16-equivalent checkpoint.
|
| 53 |
-
- Qwen3 retains its original precision; DCAE is stored in FP32. No additional training or LoRA is applied to this release.
|
| 54 |
-
- Initial model validation included 107 unit tests and eight complete inference paths, an actual 4K edit and text-encoder / VAE comparisons. See [validation conditions and measured differences](https://github.com/T8mars/Comfyui-BluePixel-T8/blob/main/docs/validation.md).
|
| 55 |
-
|
| 56 |
-
Speed, memory requirements and output quality depend on hardware and task. Download size is not a VRAM requirement. These files are intended for the linked ComfyUI integration; they are not a drop-in Diffusers pipeline directory.
|
| 57 |
-
|
| 58 |
-
## License and attribution
|
| 59 |
-
|
| 60 |
-
Weights retain their component-specific upstream terms. The diffusion model derives from FLUX.2 Klein 9B and is subject to the **FLUX Non-Commercial License**. The upstream BluePixel repository also supplies an OpenAtom model license; Qwen3 and DCAE are attributed under Apache-2.0. The upstream model card's Apache metadata does not replace the base-model restrictions.
|
| 61 |
-
|
| 62 |
-
Read [LICENSE.md](LICENSE.md), [NOTICE](NOTICE) and the preserved files in [licenses](licenses) before use. This conversion does not grant additional commercial rights. The node repository's GPL license applies to its code, not these weights.
|
| 63 |
-
|
| 64 |
-
Credits: vivo BluePixel, Black Forest Labs, Qwen, NVIDIA DCAE, ComfyUI and comfy-kitchen. Converted and packaged by T8star.
|
| 65 |
-
|
| 66 |
-
## T8star
|
| 67 |
-
|
| 68 |
-
[Bilibili](https://space.bilibili.com/385085361) · [YouTube](https://www.youtube.com/@T8star-Aix/) · [API](https://api.seedance.nz/sign-up?aff=5f4w) · [Free gallery](https://www.openzhenzhen.com) · [Online AI apps](https://www.runninghub.ai/zh-cn/user-center/1907375370302308353/userPost?inviteCode=rh-v1121) · [ComfyUI bundle](https://pan.quark.cn/s/264edb7e36bd) · [Hugging Face](https://huggingface.co/t8star)
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: other
|
| 3 |
+
license_name: bluepixel-component-licenses
|
| 4 |
+
license_link: https://huggingface.co/t8star/BluePixel-Comfy/blob/main/LICENSE.md
|
| 5 |
+
language:
|
| 6 |
+
- en
|
| 7 |
+
- zh
|
| 8 |
+
base_model: openvivo/BluePixel-Turbo
|
| 9 |
+
base_model_relation: quantized
|
| 10 |
+
pipeline_tag: image-to-image
|
| 11 |
+
library_name: comfyui
|
| 12 |
+
tags:
|
| 13 |
+
- comfyui
|
| 14 |
+
- bluepixel
|
| 15 |
+
- image-editing
|
| 16 |
+
- int8
|
| 17 |
+
- convrot
|
| 18 |
+
- 4k
|
| 19 |
+
- safetensors
|
| 20 |
+
---
|
| 21 |
+
|
| 22 |
+
# BluePixel for ComfyUI
|
| 23 |
+
|
| 24 |
+
**English** | [简体中文](README_CN.md)
|
| 25 |
+
|
| 26 |
+
Three standalone components converted from [openvivo/BluePixel-Turbo](https://huggingface.co/openvivo/BluePixel-Turbo) for native ComfyUI image editing. Use them with [ComfyUI BluePixel T8](https://github.com/T8mars/Comfyui-BluePixel-T8), which provides the loaders and eight editable canvas workflows.
|
| 27 |
+
|
| 28 |
+
## Download
|
| 29 |
+
|
| 30 |
+
Place each file in the matching folder under your ComfyUI installation. Total download: **28.19 GB** (decimal).
|
| 31 |
+
|
| 32 |
+
| Component | File | ComfyUI folder | Size |
|
| 33 |
+
| --- | --- | --- | --- |
|
| 34 |
+
| Diffusion · INT8 ConvRot | [bluepixel_turbo_int8_convrot.safetensors](diffusion_models/bluepixel_turbo_int8_convrot.safetensors) | `models/diffusion_models/` | 9.09 GB |
|
| 35 |
+
| Qwen3-8B · BF16 | [bluepixel_qwen3_8b_original.safetensors](text_encoders/bluepixel_qwen3_8b_original.safetensors) | `models/text_encoders/` | 16.39 GB |
|
| 36 |
+
| DCAE-F64 · FP32 | [bluepixel_dcae_f64.safetensors](vae/bluepixel_dcae_f64.safetensors) | `models/vae/` | 2.71 GB |
|
| 37 |
+
|
| 38 |
+
Each component is one Safetensors file. The text encoder includes its tokenizer. File sizes and SHA256 hashes are recorded in [checksums.json](checksums.json); adjacent manifests document conversion mappings and source hashes.
|
| 39 |
+
|
| 40 |
+
## Quick start
|
| 41 |
+
|
| 42 |
+
1. Install **BluePixel T8** through ComfyUI Manager, or follow the [manual installation guide](https://github.com/T8mars/Comfyui-BluePixel-T8/blob/main/README_EN.md#installation).
|
| 43 |
+
2. Download all three components above and restart ComfyUI.
|
| 44 |
+
3. Download the JSON for a [1K preview or 4K editing workflow](https://github.com/T8mars/Comfyui-BluePixel-T8/tree/main/workflows), select the files and input image, and enter an editing instruction. Open the local canvas JSON with **Ctrl+O**, or drop it onto ComfyUI.
|
| 45 |
+
4. Start with **4 steps, CFG 3**. The 4K example outputs 4096×4096.
|
| 46 |
+
|
| 47 |
+
Requires Python 3.10+, ComfyUI 0.43.0+, Diffusers 0.40+ and a compatible PyTorch / comfy-kitchen CUDA environment. Use the package's three **BluePixel Loader** nodes, then connect their standard outputs to ComfyUI sampling and VAE nodes. DCAE-F64 has 64× spatial compression and cannot be replaced by an ordinary Flux2 VAE.
|
| 48 |
+
|
| 49 |
+
## Conversion and validation
|
| 50 |
+
|
| 51 |
+
- Source weights: `openvivo/BluePixel-Turbo` at `e9c7a641a4bcd9851eef50c1ce9b07fa44f6044c`.
|
| 52 |
+
- Diffusion weights are mapped to the native Flux2/Klein layout and quantized with INT8 ConvRot. Quantization is lossy; this is not a BF16-equivalent checkpoint.
|
| 53 |
+
- Qwen3 retains its original precision; DCAE is stored in FP32. No additional training or LoRA is applied to this release.
|
| 54 |
+
- Initial model validation included 107 unit tests and eight complete inference paths, an actual 4K edit and text-encoder / VAE comparisons. See [validation conditions and measured differences](https://github.com/T8mars/Comfyui-BluePixel-T8/blob/main/docs/validation.md).
|
| 55 |
+
|
| 56 |
+
Speed, memory requirements and output quality depend on hardware and task. Download size is not a VRAM requirement. These files are intended for the linked ComfyUI integration; they are not a drop-in Diffusers pipeline directory.
|
| 57 |
+
|
| 58 |
+
## License and attribution
|
| 59 |
+
|
| 60 |
+
Weights retain their component-specific upstream terms. The diffusion model derives from FLUX.2 Klein 9B and is subject to the **FLUX Non-Commercial License**. The upstream BluePixel repository also supplies an OpenAtom model license; Qwen3 and DCAE are attributed under Apache-2.0. The upstream model card's Apache metadata does not replace the base-model restrictions.
|
| 61 |
+
|
| 62 |
+
Read [LICENSE.md](LICENSE.md), [NOTICE](NOTICE) and the preserved files in [licenses](licenses) before use. This conversion does not grant additional commercial rights. The node repository's GPL license applies to its code, not these weights.
|
| 63 |
+
|
| 64 |
+
Credits: vivo BluePixel, Black Forest Labs, Qwen, NVIDIA DCAE, ComfyUI and comfy-kitchen. Converted and packaged by T8star.
|
| 65 |
+
|
| 66 |
+
## T8star
|
| 67 |
+
|
| 68 |
+
[Bilibili](https://space.bilibili.com/385085361) · [YouTube](https://www.youtube.com/@T8star-Aix/) · [API](https://api.seedance.nz/sign-up?aff=5f4w) · [Free gallery](https://www.openzhenzhen.com) · [Online AI apps](https://www.runninghub.ai/zh-cn/user-center/1907375370302308353/userPost?inviteCode=rh-v1121) · [ComfyUI bundle](https://pan.quark.cn/s/264edb7e36bd) · [Hugging Face](https://huggingface.co/t8star)
|