必须额外从源码安装 diffusers(pip install -e .),用官方发布版可能不兼容;模型权重需从 Hugging Face 的 MeissonFlow/Meissonic 单独下载;FP8 量化对版本敏感,需 CUDA 12.4 + PyTorch 2.4.1 + TorchAO,Windows 装 TorchAO 要用 nightly 源。
Meissonic
viiikaApache-2.0活跃维护用掩码生成式 Transformer 做高分辨率文生图的官方实现,把非自回归架构重新拉回实用水平,兼顾生成效率与画质。
[ICLR 2025] Official Implementation of Meissonic: Revitalizing Masked Generative Transformers for Efficient High-Resolution Text-to-Image Synthesis
git clone https://github.com/viiika/Meissonic/ && cd Meissonic
conda create --name meissonic python && conda activate meissonic
pip install -r requirements.txt
git clone https://github.com/huggingface/diffusers.git && cd diffusers && pip install -e .
python inference.py --prompt "Your creative prompt here"README 给出 1024x1024、64 步、batch=1 的实测:FP32 约 12GB 显存、FP16 约 9.5GB、FP8 约 8.7GB,定位为消费级显卡可跑;FP8 量化需 CUDA 12.4 与 PyTorch 2.4.1。未说明 CPU 推理与具体 GPU 型号。
基于掩码生成 Transformer 的高分辨率文生图模型,能在消费级显卡上跑
用掩码生成式 Transformer 做高分辨率文生图的官方实现,把非自回归架构重新拉回实用水平,兼顾生成效率与画质。
核心能力
- 非自回归掩码图像建模,支持最高 1024x1024 分辨率
- 面向消费级 GPU 设计,FP16 下 1024 分辨率约 9.5GB 显存
- 支持文生图与图生图,附带 inpaint/outpaint 脚本
- 提供 FP8 量化推理,显存可降至约 8.7GB
- 自带 Gradio Web UI 和命令行两种推理入口
容易踩的坑
暂无 release 数据(可能没有发版,或尚未同步)。
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
Meissonic: Revitalizing Masked Generative Transformers for Efficient High-Resolution Text-to-Image Synthesis
📝 Meissonic Updates and Family Papers
-
MaskGIT: Masked Generative Image Transformer [CVPR 2022]
-
Muse: Text-To-Image Generation via Masked Generative Transformers [ICML 2023]
-
[🌟]Meissonic: Revitalizing Masked Generative Transformers for Efficient High-Resolution Text-to-Image Synthesis [ICLR 2025]
-
Bag of Design Choices for Inference of High-Resolution Masked Generative Transformer
-
Di[𝙼]O: Distilling Masked Diffusion Models into One-step Generator [ICCV 2025]
-
[🌟]Muddit: Liberating Generation Beyond Text-to-Image with a Unified Discrete Diffusion Model [ICLR 2026]
-
DC-AR: Efficient Masked Autoregressive Image Generation with Deep Compression Hybrid Tokenizer [ICCV 2025]
-
MDNS: Masked Diffusion Neural Sampler via Stochastic Optimal Control
-
Lavida-O: Elastic Large Masked Diffusion Models for Unified Multimodal Understanding and Generation
-
[🌟]Lumina-DiMOO: An Omni Diffusion Large Language Model for Multi-Modal Generation and Understanding
-
Token Painter: Training-Free Text-Guided Image Inpainting via Mask Autoregressive Models
-
TR2-D2: Tree Search Guided Trajectory-Aware Fine-Tuning for Discrete Diffusion
-
OneFlow: Concurrent Mixed-Modal and Interleaved Generation with Edit Flows
-
Diffuse Everything: Multimodal Diffusion Models on Arbitrary State Spaces [ICML 2025]
-
Towards Better & Faster Autoregressive Image Generation: From the Perspective of Entropy [NeurIPS 2025]
-
[🌟]From Masks to Worlds: A Hitchhiker's Guide to World Models
-
Soft-Di[M]O: Improving One-Step Discrete Image Generation with Soft Embeddings
-
Accelerating Inference of Masked Image Generators via Reinforcement Learning
-
Sparse-LaViDa: Sparse Multimodal Discrete Diffusion Language Models
-
Reinforcement Learning Meets Masked Generative Models: Mask-GRPO for Text-to-Image Generation
-
MaskFocus: Focusing Policy Optimization on Critical Steps for Masked Image Generation [CVPR 2026]
-
Co-GRPO: Co-Optimized Group Relative Policy Optimization for Masked Diffusion Model
-
[🌟]Prism: Efficient Test-Time Scaling via Hierarchical Search and Self-Verification for Discrete Diffusion Language Models [ICML 2026]
-
[🌟]Threshold-Guided Optimization for Visual Generative Models [ICML 2026]
-
Plug-and-Play Guidance for Discrete Diffusion Models via Gradient-Informed Logit Correction [ICML 2026]
-
UDM-GRPO: Stable and Efficient Group Relative Policy Optimization for Uniform Discrete Diffusion Models [ICML 2026]
-
Best of Both Worlds: Multimodal Reasoning and Generation via Unified Discrete Flow Matching [ICML 2026]
-
[🌟]NLD-Image: Advancing Masked Discrete Diffusion for High-Resolution Image Synthesis
-
MaskSense: Confronting the Visual Exploration Trap in Masked Image Generation [NeurIPS 2026]
-
More papers are coming soon! See MeissonFlow Research (Organization Card) for more about our vision.

🚀 Introduction
Meissonic is a non-autoregressive mask image modeling text-to-image synthesis model that can generate high-resolution images. It is designed to run on consumer graphics cards.

Key Features:
- 🖼️ High-resolution image generation (up to 1024x1024)
- 💻 Designed to run on consumer GPUs
- 🎨 Versatile applications: text-to-image, image-to-image
🛠️ Prerequisites
Step 1: Clone the repository
git clone https://github.com/viiika/Meissonic/
cd Meissonic
Step 2: Create virtual environment
conda create --name meissonic python
conda activate meissonic
pip install -r requirements.txt
Step 3: Install diffusers
git clone https://github.com/huggingface/diffusers.git
cd diffusers
pip install -e .
💡 Inference Usage
Gradio Web UI
python app.py
Command-line Interface
Text-to-Image Generation
python inference.py --prompt "Your creative prompt here"
Inpainting and Outpainting
python inpaint.py --mode inpaint --input_image path/to/image.jpg
python inpaint.py --mode outpaint --input_image path/to/image.jpg
Advanced: FP8 Quantization
Optimize performance with FP8 quantization:
Requirements:
- CUDA 12.4
- PyTorch 2.4.1
- TorchAO
Note: Windows users install TorchAO using
pip install --pre torchao --index-url https://download.pytorch.org/whl/nightly/cpu
Command-line inference
python inference_fp8.py --quantization fp8
Gradio for FP8 (Select Quantization Method in Advanced settings)
python app_fp8.py
Performance Benchmarks
| Precision (Steps=64, Resolution=1024x1024) | Batch Size=1 (Avg. Time) | Memory Usage |
|---|---|---|
| FP32 | 13.32s | 12GB |
| FP16 | 12.35s | 9.5GB |
| FP8 | 12.93s | 8.7GB |
🎨 Showcase
🎓 Training
To train Meissonic, follow these steps:
-
Install dependencies:
cd train pip install -r requirements.txt -
Download the Meissonic base model from Hugging Face.
-
Prepare your dataset:
- Use the sample dataset: MeissonFlow/splash
- Or prepare your own dataset and dataset class following the format in line 100 in dataset_utils.py and line 656-680 in train_meissonic.py
- Modify train.sh with your dataset path
-
Start training:
bash train/train.sh
Note: For custom datasets, you'll likely need to implement your own dataset class.
📚 Citation
If you find this work helpful, please consider citing:
@article{bai2024meissonic,
title={Meissonic: Revitalizing Masked Generative Transformers for Efficient High-Resolution Text-to-Image Synthesis},
author={Bai, Jinbin and Ye, Tian and Chow, Wei and Song, Enxin and Chen, Qing-Guo and Li, Xiangtai and Dong, Zhen and Zhu, Lei and Yan, Shuicheng},
journal={arXiv preprint arXiv:2410.08261},
year={2024}
}
🙏 Acknowledgements
We thank the community and contributors for their invaluable support in developing Meissonic. We thank [email protected] for making Meissonic Demo. We thank @NewGenAI and @飛鷹しずか@自称文系プログラマの勉強 for making YouTube tutorials. We thank @pprp for making fp8 and int4 quantization. We thank @camenduru for making jupyter tutorial. We thank @chenxwh for making Replicate demo and api. We thank Collov Labs for reproducing Monetico. We thank Shitong et al. for identifying effective design choices for enhancing visual quality.