Repolode
mflux-community

mflux-community/mflux

FLUX、Z-Image、Qwen Imageなど近年の画像生成モデルをApple MLXでネイティブ実装し、Mac上でローカル実行できます。

代替できる製品:Midjourney

スター
2,520
フォーク
202
未解決の Issue
13
最終コミット
昨日

これは何?

MFLUXは、Hugging FaceのDiffusersおよびTransformersライブラリにある近年の生成画像モデルを、AppleのMLXフレームワークで再実装したPythonプロジェクトです。モデルはApple Silicon搭載Mac上でローカル実行でき、CUDAやPyTorchのGPU環境を別途用意する必要はありません。重みは初回利用時に自動でダウンロードされます。

テキストからの画像生成、画像からの画像生成、LoRAの読み込みと学習、量子化に対応し、コンテキスト内編集や複数画像編集などのワークフローも利用できます。対応モデルにはFLUX.1、FLUX.2、Z-Image、Qwen Image、FIBOの各ファミリーに加え、SeedVR2によるアップスケーリングやDepth Proによる深度推定があります。モデルごとのCLIとPython APIも用意されています。

MFLUXはPyPIで配布されており、uvでインストールできます。コードは意図的に小さく明快に保たれているため、各モデルの実装を参照実装と照らし合わせて確認できます。

主な機能

  • 01MLXを使ってApple Silicon上で画像モデルをネイティブ実行でき、CUDAは不要です。
  • 02FLUX.1、FLUX.2、Z-Image、Qwen Image、FIBO、SeedVR2など、複数のモデルファミリーに対応しています。
  • 03量子化とLoRAの読み込みに対応し、複数のLoRAやLyCORIS LoKrも利用できます。
  • 04モデルごとのCLIコマンドとPython APIを提供しています。
  • 05コンテキスト内編集、インペインティング、ControlNet、アップスケーリングなどの編集機能を備えています。

ユースケース

  • プロンプトをクラウドサービスに送信せず、Mac上でローカルに画像を生成する。
  • 統一されたツールチェーンで、複数のオープンな画像モデルを試す。
  • Apple Silicon上で画像モデルにLoRAアダプターを適用する。
  • Mac上でSeedVR2を使って画像をアップスケーリングしたり、Depth Proで深度マップを推定したりする。

クイックスタート

  1. 1

    READMEのリンクからuvをインストールする

  2. 2

    uv toolとしてMFLUXをインストールする

    uv tool install --upgrade mflux
  3. 3

    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

使う前に知っておきたいこと

  • MLXを搭載したApple Silicon Mac向けに設計されているため、macOS専用です。
  • モデルは初回実行時に自動ダウンロードされます。時間がかかり、ディスク容量を多く使う場合があります。
  • Qwen Image 20Bなど一部の大規模モデルは、実行速度が遅くなります。

トピック

よくある質問

mflux とは?
FLUX、Z-Image、Qwen Imageなど近年の画像生成モデルをApple MLXでネイティブ実装し、Mac上でローカル実行できます。 MFLUXは、Hugging FaceのDiffusersおよびTransformersライブラリにある近年の生成画像モデルを、AppleのMLXフレームワークで再実装したPythonプロジェクトです。モデルはApple Silicon搭載Mac上でローカル実行でき、CUDAやPyTorchのGPU環境を別途用意する必要はありません。重みは初回利用時に自動でダウンロードされます。
mflux は無料で使えますか?ライセンスは?
mflux は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
mflux は今もメンテナンスされていますか?
活発にメンテナンス中。mflux の最終コミットは 2026年10月20日 です。
mflux は何に使えますか?
プロンプトをクラウドサービスに送信せず、Mac上でローカルに画像を生成する。 統一されたツールチェーンで、複数のオープンな画像モデルを試す。 Apple Silicon上で画像モデルにLoRAアダプターを適用する。 Mac上でSeedVR2を使って画像をアップスケーリングしたり、Depth Proで深度マップを推定したりする。
mflux のインストール方法は?
READMEのリンクからuvをインストールする uv toolとしてMFLUXをインストールする: uv tool install --upgrade mflux 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
mflux はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/mflux-community/mflux

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト