← all repositories
filipstrand/mflux

Apple Silicon's native image generator, rebuilt line by line

MFLUX re-implements state-of-the-art diffusion models in MLX so Macs can run them without PyTorch baggage.

mflux
Not currently ranked — collecting fresh signals.
star history

What it does

MFLUX is a from-scratch rewrite of modern generative image models—FLUX, Z-Image, Qwen Image, FIBO, SeedVR2—using Apple’s MLX framework instead of PyTorch. It runs locally on Apple Silicon, supports quantization, LoRA fine-tuning, ControlNet, inpainting, upscaling, and depth estimation. The project explicitly mimics Karpathy’s educational style: minimal, explicit, line-by-line.

The interesting bit

The README openly admits the easiest way to navigate its sprawling CLI in 2026 is to ask Cursor or Claude Code. That’s either refreshing honesty or a quiet admission that seven model families with divergent flags have outgrown manual documentation. Either way, the ecosystem has noticed—there are already four third-party UIs built on top.

Key highlights

  • Native MLX implementations, not PyTorch wrappers; only Hugging Face tokenizers are borrowed
  • Supports distilled and base variants across models from 3B to 20B parameters
  • Quantization, local model loading, multi-LoRA, and metadata export work across model families
  • Model-specific tricks: FIBO’s JSON prompt understanding, SeedVR2 upscaling, Qwen’s world knowledge, Depth Pro from Apple
  • Third-party frontends already exist for ComfyUI, Streamlit, FastHTML, and native macOS

Caveats

  • No training support for FIBO, SeedVR2, Qwen Image, or Depth Pro (training only available for Z-Image and FLUX.2)
  • FLUX.1 is explicitly marked “legacy” despite still being listed
  • README contains a typo (“qaility”) that has survived at least one revision

Verdict

Mac-owning ML engineers who want local image generation without CUDA dependencies should look here. PyTorch die-hards on Linux or NVIDIA hardware gain nothing—there’s a DGX install path mentioned, but the entire value proposition is MLX-native Apple Silicon performance.

Frequently asked

What is filipstrand/mflux?
MFLUX re-implements state-of-the-art diffusion models in MLX so Macs can run them without PyTorch baggage.
Is mflux open source?
Yes — filipstrand/mflux is open source, released under the MIT license.
What language is mflux written in?
filipstrand/mflux is primarily written in Python.
How popular is mflux?
filipstrand/mflux has 2.2k stars on GitHub.
Where can I find mflux?
filipstrand/mflux is on GitHub at https://github.com/filipstrand/mflux.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.