Upload folder using huggingface_hub

README.md

@@ -0,0 +1,92 @@
+---
+library_name: mlx
+tags:
+- mlx
+- flux
+- image-to-image
+- quantized
+- swift
+pipeline_tag: image-to-image
+license: other
+license_name: flux-1-dev-non-commercial-license
+license_link: https://huggingface.co/black-forest-labs/FLUX.1-dev/blob/main/LICENSE.md
+---
+
+# FLUX.1-Kontext 8-bit Quantized for MLX
+
+This is an 8-bit quantized version of the FLUX.1-Kontext-dev model optimized for use with MLX and flux.swift. The model size has been reduced from ~24GB to 17GB while maintaining excellent image-to-image generation quality.
+
+Quantized using [flux.swift](https://github.com/mzbac/flux.swift), a Swift implementation of FLUX models for Apple Silicon.
+
+## Model Details
+- **Quantization**: 8-bit with group size 128
+- **Total Size**: 17GB
+- **Original Model**: [black-forest-labs/FLUX.1-Kontext-dev](https://huggingface.co/black-forest-labs/FLUX.1-Kontext-dev)
+- **Framework**: MLX (Metal Performance Shaders)
+- **Components**: Transformer, VAE, CLIP text encoder, T5 text encoder
+
+## Usage
+
+This model requires the [flux.swift](https://github.com/mzbac/flux.swift) implementation. Please refer to the repository for installation and usage instructions.
+
+### Quick Start
+```bash
+# Load and use the quantized model for image-to-image generation
+flux.swift.cli \
+  --load-quantized-path /path/to/this/model \
+  --hf-token YOUR_HF_TOKEN \
+  --init-image-path /path/to/input/image.png \
+  --prompt "Your transformation prompt here" \
+  --output output.png
+```
+
+### Recommended Parameters
+- **Steps**: 30
+- **Guidance Scale**: 3.5
+- **Authentication**: Requires Hugging Face token
+- **Input**: Requires `--init-image-path` for image-to-image generation
+
+### Example with Parameters
+```bash
+flux.swift.cli \
+  --load-quantized-path /path/to/this/model \
+  --hf-token YOUR_HF_TOKEN \
+  --init-image-path ./reference.png \
+  --prompt "transform this into a watercolor painting with soft pastel tones" \
+  --steps 30 \
+  --guidance 3.5 \
+  --width 512 \
+  --height 512 \
+  --seed 42 \
+  --output watercolor_painting.png
+```
+
+## License
+
+This model is a quantized version of FLUX.1-Kontext-dev, which is licensed under the FLUX.1 [dev] Non-Commercial License. Please review the original license terms:
+- Original model: https://huggingface.co/black-forest-labs/FLUX.1-Kontext-dev
+- License: https://huggingface.co/black-forest-labs/FLUX.1-dev/blob/main/LICENSE.md
+- Commercial licensing available at: https://bfl.ai/pricing/licensing
+
+## Performance
+- **Memory Usage**: Reduced from ~24GB to 17GB
+- **Quality**: Excellent preservation of image-to-image generation quality
+- **Platform**: Optimized for Apple Silicon Macs
+
+## Citation
+```bibtex
+@misc{flux-kontext,
+  author = {Black Forest Labs},
+  title = {FLUX.1-Kontext-dev},
+  publisher = {Black Forest Labs},
+  year = {2024},
+  url = {https://huggingface.co/black-forest-labs/FLUX.1-Kontext-dev}
+}
+
+@software{flux-swift,
+  author = {mzbac},
+  title = {flux.swift: Swift implementation of FLUX models},
+  url = {https://github.com/mzbac/flux.swift},
+  year = {2024}
+}
+```

metadata.json

@@ -0,0 +1,13 @@
+{
+  "quantizationBits" : 8,
+  "fluxSwiftVersion" : "1.0.0",
+  "components" : [
+    "vae",
+    "transformer",
+    "text_encoder",
+    "text_encoder_2"
+  ],
+  "groupSize" : 128,
+  "createdAt" : "2025-07-04T08:44:14Z",
+  "modelType" : "FluxKontextPipeline"
+}

text_encoder/flux1_mlx_model.safetensors

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

text_encoder_2/flux1_mlx_model-00001-of-00003.safetensors

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

text_encoder_2/flux1_mlx_model-00002-of-00003.safetensors

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

text_encoder_2/flux1_mlx_model-00003-of-00003.safetensors

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

transformer/flux1_mlx_model-00001-of-00007.safetensors

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

transformer/flux1_mlx_model-00002-of-00007.safetensors

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

transformer/flux1_mlx_model-00003-of-00007.safetensors

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

transformer/flux1_mlx_model-00004-of-00007.safetensors

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

transformer/flux1_mlx_model-00005-of-00007.safetensors

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

transformer/flux1_mlx_model-00006-of-00007.safetensors

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

transformer/flux1_mlx_model-00007-of-00007.safetensors

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

vae/flux1_mlx_model.safetensors

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