mflux-community/mflux

O que é?

Recursos principais

• 01Executa modelos de imagem nativamente em Apple Silicon usando MLX, sem precisar de CUDA.
• 02Oferece suporte a FLUX.1, FLUX.2, Z-Image, Qwen Image, FIBO, SeedVR2 e outras famílias de modelos.
• 03Oferece quantização e carregamento de LoRA, incluindo multi-LoRA e LyCORIS LoKr.
• 04Disponibiliza comandos de CLI para cada modelo e uma API Python.
• 05Inclui recursos de edição como edição in-context, inpainting, ControlNet e upscaling.

Casos de uso

• Gerar imagens localmente no Mac sem enviar prompts para um serviço na nuvem.
• Experimentar vários modelos abertos de imagem usando uma única toolchain consistente.
• Aplicar adaptadores LoRA a modelos de imagem em Apple Silicon.
• Fazer upscaling de imagens com SeedVR2 ou estimar mapas de profundidade com Depth Pro no Mac.

Início rápido

1. 1

   Instale o uv pelo link no README

2. 2

   Instale o MFLUX como uma ferramenta do uv

   uv tool install --upgrade mflux
3. 3

   Gere sua primeira imagem com o modelo Z-Image Turbo

   mflux-generate-z-image-turbo \ --prompt "A puffin standing on a cliff" \ --width 1280 \ --height 500 \ --seed 42 \ --steps 9 \ -q 8

Antes de usar

• !Foi desenvolvido para Macs com Apple Silicon que executam MLX, então funciona apenas no macOS.
• !Os modelos são baixados automaticamente na primeira execução, o que pode demorar bastante e ocupar muito espaço em disco.
• !Alguns modelos grandes, como o Qwen Image de 20B, são mais lentos.

Tópicos

Perguntas frequentes

O que é mflux?

Implementações nativas em Apple MLX de modelos recentes de geração de imagens (FLUX, Z-Image, Qwen Image e outros) para execução local no Mac. MFLUX é um projeto em Python que reimplementa vários modelos recentes de geração de imagens das bibliotecas Hugging Face Diffusers e Transformers no framework MLX da Apple. Os modelos são executados localmente em Macs com Apple Silicon, sem precisar de uma stack separada de CUDA ou PyTorch para GPU, e os pesos são baixados automaticamente no primeiro uso.

mflux é gratuito? Qual é a licença?

mflux é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

mflux ainda é mantido?

Manutenção ativa. O último commit de mflux foi em 20 de out. de 2026.

Para que posso usar mflux?

Gerar imagens localmente no Mac sem enviar prompts para um serviço na nuvem. Experimentar vários modelos abertos de imagem usando uma única toolchain consistente. Aplicar adaptadores LoRA a modelos de imagem em Apple Silicon. Fazer upscaling de imagens com SeedVR2 ou estimar mapas de profundidade com Depth Pro no Mac.

Como instalar mflux?

Instale o uv pelo link no README Instale o MFLUX como uma ferramenta do uv: uv tool install --upgrade mflux Gere sua primeira imagem com o modelo Z-Image Turbo: mflux-generate-z-image-turbo \ --prompt "A puffin standing on a cliff" \ --width 1280 \ --height 500 \ --seed 42 \ --steps 9 \ -q 8

Onde consigo mflux?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/mflux-community/mflux