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 4-bit Quantized for MLX
+
+This is a 4-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 9.2GB 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**: 4-bit with group size 64
+- **Total Size**: 9.2GB
+- **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 9.2GB
+- **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" : 4,
+  "fluxSwiftVersion" : "1.0.0",
+  "createdAt" : "2025-07-03T13:53:16Z",
+  "modelType" : "FluxKontextPipeline",
+  "components" : [
+    "vae",
+    "transformer",
+    "text_encoder",
+    "text_encoder_2"
+  ],
+  "groupSize" : 64
+}

text_encoder/flux1_mlx_model.safetensors

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

text_encoder_2/flux1_mlx_model-00001-of-00002.safetensors

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

text_encoder_2/flux1_mlx_model-00002-of-00002.safetensors

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

transformer/flux1_mlx_model-00001-of-00004.safetensors

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

transformer/flux1_mlx_model-00002-of-00004.safetensors

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

transformer/flux1_mlx_model-00003-of-00004.safetensors

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

transformer/flux1_mlx_model-00004-of-00004.safetensors

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

vae/flux1_mlx_model.safetensors

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