t8star commited on
Commit
30af1dd
·
verified ·
1 Parent(s): f043558

Normalize model card line endings

Browse files
Files changed (1) hide show
  1. README.md +68 -68
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)