Instructions to use mlx-community/Devstral-Small-2-24B-Instruct-2512-4bit with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use mlx-community/Devstral-Small-2-24B-Instruct-2512-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("mlx-community/Devstral-Small-2-24B-Instruct-2512-4bit")
config = load_config("mlx-community/Devstral-Small-2-24B-Instruct-2512-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

How to use mlx-community/Devstral-Small-2-24B-Instruct-2512-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 "mlx-community/Devstral-Small-2-24B-Instruct-2512-4bit"

Configure the model in Pi

# Install Pi:
npm install -g @earendil-works/pi-coding-agent
# Add to ~/.pi/agent/models.json:
{
  "providers": {
    "mlx-lm": {
      "baseUrl": "http://localhost:8080/v1",
      "api": "openai-completions",
      "apiKey": "none",
      "models": [
        {
          "id": "mlx-community/Devstral-Small-2-24B-Instruct-2512-4bit"
        }
      ]
    }
  }
}

Run Pi

# Start Pi in your project directory:
pi

Hermes Agent

How to use mlx-community/Devstral-Small-2-24B-Instruct-2512-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 "mlx-community/Devstral-Small-2-24B-Instruct-2512-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 mlx-community/Devstral-Small-2-24B-Instruct-2512-4bit

Run Hermes

hermes

Atomic Chat

OpenClaw

How to use mlx-community/Devstral-Small-2-24B-Instruct-2512-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 "mlx-community/Devstral-Small-2-24B-Instruct-2512-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 "mlx-community/Devstral-Small-2-24B-Instruct-2512-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"

prince-canuma commited on Jul 4

Commit

9722855

verified ·

1 Parent(s): 91e678b

Re-upload mistralai/Devstral-Small-2-24B-Instruct-2512 MLX 4bit

Browse files

Converted from mistralai/Devstral-Small-2-24B-Instruct-2512 at revision c599e8e56f3f9110e97f0dc0450ce248e3334d84 with the current mlx-vlm checkout. README.md is intentionally preserved from the existing repository card.

Files changed (6) hide show

config.json +78 -78
model-00001-of-00003.safetensors +2 -2
model-00002-of-00003.safetensors +2 -2
model-00003-of-00003.safetensors +2 -2
processor_config.json +0 -1
tokenizer_config.json +1 -1

config.json CHANGED Viewed

@@ -1,83 +1,83 @@
 {
-  "architectures": [
-    "Mistral3ForConditionalGeneration"
-  ],
-  "do_sample": true,
-  "dtype": "bfloat16",
-  "eos_token_id": 2,
-  "generation_config": {
-    "bos_token_id": 1,
     "do_sample": true,
     "eos_token_id": 2,
-    "max_length": 262144,
-    "pad_token_id": 11,
     "temperature": 0.15,
-    "transformers_version": "5.0.0.dev0"
-  },
-  "image_token_index": 10,
-  "model_type": "mistral3",
-  "multimodal_projector_bias": false,
-  "projector_hidden_act": "gelu",
-  "quantization": {
-    "bits": 4,
-    "group_size": 64,
-    "mode": "affine"
-  },
-  "quantization_config": {
-    "bits": 4,
-    "group_size": 64,
-    "mode": "affine"
-  },
-  "spatial_merge_size": 2,
-  "temperature": 0.15,
-  "text_config": {
-    "attention_dropout": 0.0,
-    "head_dim": 128,
-    "hidden_act": "silu",
-    "hidden_size": 5120,
-    "initializer_range": 0.02,
-    "intermediate_size": 32768,
-    "max_position_embeddings": 393216,
-    "model_type": "ministral3",
-    "num_attention_heads": 32,
-    "num_hidden_layers": 40,
-    "num_key_value_heads": 8,
-    "rms_norm_eps": 1e-05,
-    "rope_parameters": {
-      "beta_fast": 32.0,
-      "beta_slow": 1.0,
-      "factor": 48.0,
-      "llama_4_scaling_beta": 0.1,
-      "mscale": 1.0,
-      "mscale_all_dim": 1.0,
-      "original_max_position_embeddings": 8192,
-      "rope_theta": 100000000.0,
-      "rope_type": "yarn",
-      "type": "yarn"
     },
-    "sliding_window": null,
-    "use_cache": true,
-    "vocab_size": 131072
-  },
-  "tie_word_embeddings": false,
-  "transformers_version": "5.0.0.dev0",
-  "vision_config": {
-    "attention_dropout": 0.0,
-    "head_dim": 64,
-    "hidden_act": "silu",
-    "hidden_size": 1024,
-    "image_size": 1540,
-    "initializer_range": 0.02,
-    "intermediate_size": 4096,
-    "model_type": "pixtral",
-    "num_attention_heads": 16,
-    "num_channels": 3,
-    "num_hidden_layers": 24,
-    "patch_size": 14,
-    "rope_parameters": {
-      "rope_theta": 10000.0,
-      "rope_type": "default"
-    }
-  },
-  "vision_feature_layer": -1
-}

 {
+    "architectures": [
+        "Mistral3ForConditionalGeneration"
+    ],
     "do_sample": true,
+    "dtype": "bfloat16",
     "eos_token_id": 2,
+    "generation_config": {
+        "bos_token_id": 1,
+        "eos_token_id": 2,
+        "max_length": 262144,
+        "pad_token_id": 11,
+        "do_sample": true,
+        "temperature": 0.15,
+        "transformers_version": "5.0.0.dev0"
+    },
+    "image_token_index": 10,
+    "model_type": "mistral3",
+    "multimodal_projector_bias": false,
+    "projector_hidden_act": "gelu",
+    "quantization": {
+        "group_size": 64,
+        "bits": 4,
+        "mode": "affine"
+    },
+    "quantization_config": {
+        "group_size": 64,
+        "bits": 4,
+        "mode": "affine"
+    },
+    "spatial_merge_size": 2,
     "temperature": 0.15,
+    "text_config": {
+        "attention_dropout": 0.0,
+        "head_dim": 128,
+        "hidden_act": "silu",
+        "hidden_size": 5120,
+        "initializer_range": 0.02,
+        "intermediate_size": 32768,
+        "max_position_embeddings": 393216,
+        "model_type": "ministral3",
+        "num_attention_heads": 32,
+        "num_hidden_layers": 40,
+        "num_key_value_heads": 8,
+        "rms_norm_eps": 1e-05,
+        "rope_parameters": {
+            "beta_fast": 32.0,
+            "beta_slow": 1.0,
+            "factor": 48.0,
+            "llama_4_scaling_beta": 0.1,
+            "mscale": 1.0,
+            "mscale_all_dim": 1.0,
+            "original_max_position_embeddings": 8192,
+            "rope_theta": 100000000.0,
+            "rope_type": "yarn",
+            "type": "yarn"
+        },
+        "sliding_window": null,
+        "use_cache": true,
+        "vocab_size": 131072
+    },
+    "tie_word_embeddings": false,
+    "transformers_version": "5.0.0.dev0",
+    "vision_config": {
+        "attention_dropout": 0.0,
+        "head_dim": 64,
+        "hidden_act": "silu",
+        "hidden_size": 1024,
+        "image_size": 1540,
+        "initializer_range": 0.02,
+        "intermediate_size": 4096,
+        "model_type": "pixtral",
+        "num_attention_heads": 16,
+        "num_channels": 3,
+        "num_hidden_layers": 24,
+        "patch_size": 14,
+        "rope_parameters": {
+            "rope_theta": 10000.0,
+            "rope_type": "default"
+        }
     },
+    "vision_feature_layer": -1
+}

model-00001-of-00003.safetensors CHANGED Viewed

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:4affee474ddbe0f045e9786e0ad5808308b668930dc7c2e13c9a7af00035ed19
-size 5349121606

 version https://git-lfs.github.com/spec/v1
+oid sha256:bf03240339489cbf7582654c237b7c7bba729640eb5957fbb8918b889d9a8e91
+size 5349121612

model-00002-of-00003.safetensors CHANGED Viewed

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:e86e056f0fd88cb0b2923a69100db9cf791dbce35568859db92b1ae3f9c100af
-size 5314713080

 version https://git-lfs.github.com/spec/v1
+oid sha256:1adbf960fd4eee50836d54683dd0a8915976ec57a6326cfa0588238fa6c6e69f
+size 5314713116

model-00003-of-00003.safetensors CHANGED Viewed

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:04c3df3e14a740b6645b3f2973bed704d3c32d5c246e4a586dbbc2c8ac6564c2
-size 4438996692

 version https://git-lfs.github.com/spec/v1
+oid sha256:562933b8e4840869a912bf0d9ba1b53a7ebd13619f299342d0c0e2229b95a639
+size 4438996896

processor_config.json CHANGED Viewed

@@ -24,7 +24,6 @@
     ],
     "pad_size": null,
     "patch_size": 14,
-    "processor_class": "Mistral3Processor",
     "resample": 3,
     "rescale_factor": 0.00392156862745098,
     "size": {

     ],
     "pad_size": null,
     "patch_size": 14,
     "resample": 3,
     "rescale_factor": 0.00392156862745098,
     "size": {

tokenizer_config.json CHANGED Viewed

@@ -1,5 +1,4 @@
 {
-  "additional_special_tokens": null,
   "backend": "tokenizers",
   "bos_token": "<s>",
   "eos_token": "</s>",
@@ -1006,6 +1005,7 @@
     "<SPECIAL_999>"
   ],
   "is_local": true,
   "model_max_length": 1000000000000000019884624838656,
   "pad_token": "<pad>",
   "processor_class": "Mistral3Processor",

 {
   "backend": "tokenizers",
   "bos_token": "<s>",
   "eos_token": "</s>",
     "<SPECIAL_999>"
   ],
   "is_local": true,
+  "local_files_only": false,
   "model_max_length": 1000000000000000019884624838656,
   "pad_token": "<pad>",
   "processor_class": "Mistral3Processor",