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

text_encoder/flux1_mlx_model.safetensors

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

text_encoder_2/flux1_mlx_model-00001-of-00002.safetensors

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

text_encoder_2/flux1_mlx_model-00002-of-00002.safetensors

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

transformer/flux1_mlx_model-00001-of-00004.safetensors

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

transformer/flux1_mlx_model-00002-of-00004.safetensors

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

transformer/flux1_mlx_model-00003-of-00004.safetensors

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

transformer/flux1_mlx_model-00004-of-00004.safetensors

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

vae/flux1_mlx_model.safetensors

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