Upload folder using huggingface_hub

README.md

@@ -0,0 +1,90 @@
+---
+library_name: mlx
+tags:
+- mlx
+- flux
+- text-to-image
+- quantized
+- swift
+pipeline_tag: text-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-dev 8-bit Quantized for MLX
+
+This is an 8-bit quantized version of the FLUX.1-dev model optimized for use with MLX and flux.swift. The model size has been reduced from ~24GB to 17GB while maintaining excellent 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-dev](https://huggingface.co/black-forest-labs/FLUX.1-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
+flux.swift.cli \
+  --load-quantized-path /path/to/this/model \
+  --hf-token YOUR_HF_TOKEN \
+  --prompt "Your prompt here" \
+  --output output.png
+```
+
+### Recommended Parameters
+- **Steps**: 10+ (for quality)
+- **Guidance Scale**: 7.5
+- **Authentication**: Requires Hugging Face token
+- **Use Case**: High-quality generation
+
+### Example with Parameters
+```bash
+flux.swift.cli \
+  --load-quantized-path /path/to/this/model \
+  --hf-token YOUR_HF_TOKEN \
+  --prompt "A futuristic robot in a cyberpunk city" \
+  --steps 20 \
+  --guidance 7.5 \
+  --width 768 \
+  --height 768 \
+  --seed 42 \
+  --output cyberpunk_robot.png
+```
+
+## License
+
+This model is a quantized version of FLUX.1-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-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 generation quality
+- **Platform**: Optimized for Apple Silicon Macs
+
+## Citation
+```bibtex
+@misc{flux-dev,
+  author = {Black Forest Labs},
+  title = {FLUX.1-dev},
+  publisher = {Black Forest Labs},
+  year = {2024},
+  url = {https://huggingface.co/black-forest-labs/FLUX.1-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,
+  "components" : [
+    "vae",
+    "transformer",
+    "text_encoder",
+    "text_encoder_2"
+  ],
+  "groupSize" : 128,
+  "createdAt" : "2025-07-04T08:42:06Z",
+  "fluxSwiftVersion" : "1.0.0",
+  "modelType" : "FluxPipeline"
+}

text_encoder/flux1_mlx_model.safetensors

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

text_encoder_2/flux1_mlx_model-00001-of-00003.safetensors

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

text_encoder_2/flux1_mlx_model-00002-of-00003.safetensors

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

text_encoder_2/flux1_mlx_model-00003-of-00003.safetensors

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

transformer/flux1_mlx_model-00001-of-00007.safetensors

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

transformer/flux1_mlx_model-00002-of-00007.safetensors

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

transformer/flux1_mlx_model-00003-of-00007.safetensors

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

transformer/flux1_mlx_model-00004-of-00007.safetensors

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

transformer/flux1_mlx_model-00005-of-00007.safetensors

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

transformer/flux1_mlx_model-00006-of-00007.safetensors

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

transformer/flux1_mlx_model-00007-of-00007.safetensors

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

vae/flux1_mlx_model.safetensors

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