Instructions to use JoyFusionAI/Qwen-Image-2.1-MLX-8bit with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- mflux
How to use JoyFusionAI/Qwen-Image-2.1-MLX-8bit with mflux:
# No code snippets available yet for this library. # To use this model, check the repository files and the library's documentation. # Want to help? PRs adding snippets are welcome at: # https://github.com/huggingface/huggingface.js
- MLX
How to use JoyFusionAI/Qwen-Image-2.1-MLX-8bit with MLX:
# Download the model from the Hub pip install huggingface_hub[hf_xet] huggingface-cli download --local-dir Qwen-Image-2.1-MLX-8bit JoyFusionAI/Qwen-Image-2.1-MLX-8bit
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- LM Studio
- Atomic Chat
Qwen-Image-2.1 · MLX 8-bit (mflux)
Qwen/Qwen-Image-2.1 quantized to 8-bit for Apple Silicon with
mflux (mflux-save -q 8, commit 8c00dab2).
| Component | Precision | Size |
|---|---|---|
| Transformer (7B single-stream DiT) | 8-bit (MLX affine, group 64) | 7.1 GiB |
| Text encoder (Qwen3-VL-8B) | bf16 (mflux keeps it unquantized) | 14 GiB |
| VAE (64-channel) | 8-bit linear layers, conv layers bf16 | 1.2 GiB |
| Total | ~23 GB |
Usage
Requires an mflux build that includes Qwen-Image-2.1 support (mflux main at or after 8c00dab2).
mflux-generate-qwen-2.1 \
--model JoyFusionAI/Qwen-Image-2.1-MLX-8bit \
--base-model qwen-image-2.1 \
--prompt "A red fox in a snowy forest holding a wooden sign that says \"Hello\"" \
--steps 40 --low-ram
--low-ram releases the text encoder after prompt encoding and tiles the VAE decode. Measured on an
M1 Max at 768×768: peak memory ~10 GB (vs. 33–36 GB without it), ~6.7 s/step, no visible quality change.
Defaults recommended by the model authors: 40 steps, no guidance. Image sizes must be divisible by 16.
License
These weights are a derivative of Qwen-Image-2.1 and are distributed under the Qwen Research License Agreement. Non-commercial research and evaluation use only; commercial use requires a separate license from the Qwen team. See the original license.
Qwen-Image-2.1 is licensed under the Qwen RESEARCH LICENSE AGREEMENT, Copyright (c) Alibaba Cloud. All Rights Reserved.
- Downloads last month
- 3,186
Quantized
Model tree for JoyFusionAI/Qwen-Image-2.1-MLX-8bit
Base model
Qwen/Qwen-Image-2.1