Instructions to use AutomatosX/AX-DiffusionGemma-26B-A4B-IT-MLX-4bit with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use AutomatosX/AX-DiffusionGemma-26B-A4B-IT-MLX-4bit with MLX:
# Make sure mlx-vlm is installed # pip install --upgrade mlx-vlm from mlx_vlm import load, generate from mlx_vlm.prompt_utils import apply_chat_template from mlx_vlm.utils import load_config # Load the model model, processor = load("AutomatosX/AX-DiffusionGemma-26B-A4B-IT-MLX-4bit") config = load_config("AutomatosX/AX-DiffusionGemma-26B-A4B-IT-MLX-4bit") # Prepare input image = ["http://images.cocodataset.org/val2017/000000039769.jpg"] prompt = "Describe this image." # Apply chat template formatted_prompt = apply_chat_template( processor, config, prompt, num_images=1 ) # Generate output output = generate(model, processor, formatted_prompt, image) print(output) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- LM Studio
- Pi
How to use AutomatosX/AX-DiffusionGemma-26B-A4B-IT-MLX-4bit with Pi:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "AutomatosX/AX-DiffusionGemma-26B-A4B-IT-MLX-4bit"
Configure the model in Pi
# Install Pi: npm install -g @mariozechner/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "mlx-lm": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "AutomatosX/AX-DiffusionGemma-26B-A4B-IT-MLX-4bit" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use AutomatosX/AX-DiffusionGemma-26B-A4B-IT-MLX-4bit with Hermes Agent:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "AutomatosX/AX-DiffusionGemma-26B-A4B-IT-MLX-4bit"
Configure Hermes
# Install Hermes: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash hermes setup # Point Hermes at the local server: hermes config set model.provider custom hermes config set model.base_url http://127.0.0.1:8080/v1 hermes config set model.default AutomatosX/AX-DiffusionGemma-26B-A4B-IT-MLX-4bit
Run Hermes
hermes
- OpenClaw new
How to use AutomatosX/AX-DiffusionGemma-26B-A4B-IT-MLX-4bit with OpenClaw:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "AutomatosX/AX-DiffusionGemma-26B-A4B-IT-MLX-4bit"
Configure OpenClaw
# Install OpenClaw: npm install -g openclaw@latest # Register the local server and set it as the default model: openclaw onboard --non-interactive --mode local \ --auth-choice custom-api-key \ --custom-base-url http://127.0.0.1:8080/v1 \ --custom-model-id "AutomatosX/AX-DiffusionGemma-26B-A4B-IT-MLX-4bit" \ --custom-provider-id mlx-lm \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
AX DiffusionGemma 26B-A4B IT MLX 4-bit
Parameter count: approximately 25.82B logical parameters (26B total, approximately 4B active per token).
4-bitis the quantization precision, not a 4B model-size claim.
Transparent upstream mirror — AutomatosX made no model changes.
This is a revision-pinned, transparent mirror of
mlx-community/diffusiongemma-26B-A4B-it-4bit
at commit a7a81407613811e8ba63af92ac0d852b809e191f.
AutomatosX did not train, fine-tune, merge, convert, quantize, re-quantize, or
otherwise alter the weights, configuration, tokenizer, processor, chat
template, or generation settings. The MLX conversion and quantization were
performed upstream by MLX Community with mlx-vlm 0.6.3. AutomatosX adds only
this mirror documentation, the preserved upstream model card, a copy of the
declared license, machine-readable provenance, and a total_parameters field
in the shard index so the Hub does not mistake packed 4-bit storage for the
logical model size.
Model details
- Base model: google/diffusiongemma-26B-A4B-it
- Upstream MLX source: mlx-community/diffusiongemma-26B-A4B-it-4bit
- Format: MLX Safetensors for Apple Silicon
- Architecture:
DiffusionGemmaForBlockDiffusion, mixture of experts - Quantization: upstream 4-bit affine, group size 64, with the upstream 8-bit exceptions unchanged
- Weight shards: 4, totaling 16,543,055,405 bytes
- Generation: block-autoregressive discrete diffusion with a 256-token canvas
- MTP: not applicable; this is not an autoregressive next-token model
Download
hf download AutomatosX/AX-DiffusionGemma-26B-A4B-IT-MLX-4bit \
--local-dir ./AX-DiffusionGemma-26B-A4B-IT-MLX-4bit
Use with MLX-VLM
pip install -U mlx-vlm
python -m mlx_vlm.generate \
--model AutomatosX/AX-DiffusionGemma-26B-A4B-IT-MLX-4bit \
--max-tokens 100 \
--temperature 0.0 \
--prompt "Describe this image." \
--image <path_to_image>
Try with AX Engine
AX Engine has an experimental native MLX path for DiffusionGemma. Its download workflow generates the local runtime manifest without changing the published model artifacts:
ax-engine serve AutomatosX/AX-DiffusionGemma-26B-A4B-IT-MLX-4bit \
--download --port 31418
DiffusionGemma support in AX Engine is experimental and is not recommended for production use. Its first visible output is a committed diffusion block, so ordinary autoregressive TTFT and decode-throughput comparisons do not apply.
Mirror policy and provenance
UPSTREAM_README.md preserves the original MLX Community model card.
ax_provenance.json pins the source commit and records SHA-256 values and sizes
for every mirrored artifact. All weight shards and all source artifacts other
than the replaced model card and shard index are byte-identical to the pinned
upstream revision. In the index, weight_map and total_size remain unchanged;
only the logical total_parameters metadata field was added.
This repository exists for revision-pinned cataloging and convenient discovery; it does not represent a new model, conversion, quantization, or benchmark claim from AutomatosX.
License and responsible use
The upstream MLX repository and Google base model declare Apache License 2.0.
See LICENSE, the preserved upstream card, and the
Google base-model card
for usage limitations, safety guidance, and responsible-use considerations.
- Downloads last month
- 147
4-bit
Model tree for AutomatosX/AX-DiffusionGemma-26B-A4B-IT-MLX-4bit
Base model
google/diffusiongemma-26B-A4B-it