Fast Stable Diffusion CLI
Powered by Diffusers
Designed for Linux
| MDX | 0.8.6 |
|---|---|
| Python | 3.11, 3.12 |
| Torch | 2.3.1 +cu121 |
| Diffusers | 0.29.2 |
- SD, SDXL
- Load VAE and LoRA weights
- TAESD latents preview (image and animation)
- Txt2Img, Img2Img, Inpaint (automatic pipeline)
- Batch image generation, multiple images per prompt
- Read/write PNG metadata, auto-rename files
- CPU, GPU, Low VRAM mode (automatic on 4GB cards)
- Lightweight and fast, rewritten in 300 lines
- Proxy, offline mode, minimal downloads
- Free to use, study, modify, and distribute
- Addons: Real-ESRGAN upscaler x4 script
- New mdx editor
- SD3 is currently not supported, some changes to Diffusers pipelines are needed to fit SD3 in our 300 line script. prototype
- 3GB Python packages (5.2GB extracted)
- 50MB Huggingface cache (automatic, mostly for TAESD)
- Make sure you have a swap partition or swap file
git clone https://github.com/nimadez/mental-diffusion
cd mental-diffusion
Automatic installation: (debian-based)
apt install python3-pip python3-venv
sh install-venv.sh
sh install-bin.sh
Manual installation:
python3 -m venv ~/.venv/mdx
source ~/.venv/mdx/bin/activate
pip install torch torchvision --extra-index-url https://download.pytorch.org/whl/cu121
pip install -r ./requirements.txt
deactivate
(optional) Install realesrgan for the upscaler x4 script:
~/.venv/mdx/bin/python3 -m pip install realesrgan
~/.venv/mdx/bin/python3 mdx.py --help
--type -t str sd, xl (def: custom)
--checkpoint -c str checkpoint.safetensors (def: custom)
--scheduler -sc str ddim, ddpm, lcm, pndm, eulera, euler, lms (def: custom)
--prompt -p str positive prompt
--negative -n str negative prompt
--width -w int divisible by 8 (def: custom)
--height -h int divisible by 8 (def: custom)
--seed -s int -1 randomize (def: -1)
--steps -st int 1 to 100+ (def: 24)
--guidance -g float 0 - 20.0+ (def: 8.0)
--strength -sr float 0 - 1.0 (def: 1.0)
--lorascale -ls float 0 - 1.0 (def: 1.0)
--image -i str image.png
--mask -m str mask.png
--vae -v str vae.safetensors
--lora -l str lora.safetensors
--filename -f str filename prefix without .png extension, add {seed} to be replaced (def: img_{seed})
--output -o str image and preview output directory (def: custom)
--number -no int number of images to generate per prompt (def: 1)
--batch -b int number of repeats to run in batch, --seed -1 to randomize
--preview -pv stepping is slower with preview enabled (def: no preview)
--lowvram -lv slower if you have enough VRAM, automatic on 4GB cards (def: no lowvram)
--metadata -meta str image.png, extract metadata from png
Default: mdx -p "prompt" -st 28 -g 7.5
SD: mdx -t sd -c ./checkpoint.safetensors -w 512 -h 512
SDXL: mdx -t xl -c ./checkpoint.safetensors -w 768 -h 768
Img2Img: mdx -i ./image.png -sr 0.5
Inpaint: mdx -i ./image.png -m ./mask.png
VAE: mdx -v ./vae.safetensors
LoRA: mdx -l ./lora.safetensors -ls 0.5
Filename: mdx -f img_test_{seed}
Output: mdx -o /home/user/.mdx
Number: mdx -no 4
Batch: mdx -b 10
Preview: mdx -pv
Low VRAM: mdx -lv
Metadata: mdx -meta ./image.png
RealESRGAN: upscale ./image.png /home/user/.mdx
A simple editor for MDX arguments,
No server is used and no changes have been made to the mdx.py,
In short, this webui only works with arguments and the output directory specified by the user.
✓ Easy file and image inputs
✓ Live preview
✓ Autosave text and numeric inputs
✓ Copy the complete command with all arguments
✓ Resolution presets
✓ Upscaler
✓ Configuration (custom python path)
Install Electron for Linux
cd mental-diffusion
electron ./editor . &
To reset all settings to default:
rm -r ~/.config/mental-diffusion
Drag-n-drop the preview to continue with Img2Img, use strength 0.5
* Enable OFFLINE if you have already downloaded the huggingface cache
* Enable SAVE_ANIM to save preview animation to ~/.mdx/filename.webp
Preview, cancel, and repeat with higher steps:
mdx -p "prompt" -g 8.0 -st 15 -pv
mdx -p "prompt" -g 8.0 -st 30 -s 827362763262387
Improve details with Img2Img pipeline:
mdx -p "prompt" -st 20 -f myimage
mdx -p "prompt" -st 30 -i ~/.mdx/image.png -sr 0.15
Content-aware upscaling: (ImageMagick, similar to A1111 hires-fix)
mdx -p "prompt" -st 20 -w 512 -h 512 -f image
magick convert ~/.mdx/image.png -resize 200% ~/.mdx/image_up.png
mdx -p "prompt" -st 20 -i ~/.mdx/image_up.png -sr 0.5
Generate 40 images in less time:
mdx -p "prompt" -b 10 -no 4
Extract images from WebP animation: (ImageMagick)
magick convert image.webp jpg
Create images across the LAN via SSH:
apt install openssh-server && ssh-keygen -t rsa -b 4096
ssh user@192.168.x.x
$ mdx -p "prompt"
Explore output directory in a browser across the LAN:
Notice: I recommend using a dedicated and secure web server
cd ~/.mdx && python3 -m http.server 8000
$ open http://192.168.x.x:8000
Download huggingface cache in a specific path:
mkdir ~/.hfcache && ln -s ~/.hfcache ~/.cache/huggingface
Tested on Debian Trixie (testing branch) with nvidia driver 535
| SD CPU | SD GPU | SDXL GPU | |
|---|---|---|---|
| Txt2Img | ✓ | ✓ | ✓ |
| Img2Img | ✓ | ✓ | ✓ |
| Inpaint | ✓ | ✓ | ✓ |
| VAE | ✓ | ✓ | ✓ |
| LoRA | ✓ | ✓ | ✓ |
| Batch | ✓ | ✓ | ✓ |
| Preview | ✓ | ✓ | ✓ |
| Low VRAM | ✓ | ✓ |
↑ Rewritten in 300 lines
↑ Port to Linux
↑ Back to Diffusers
↑ Port to Code (webui)
↑ Change to ComfyUI API (webui)
↑ Created for personal use on Windows OS (diffusers)
"AI will bring us back to the age of terminals."
Code released under the MIT license.