Instructions to use cs2764/MiniMax-M2.5_dq4-mlx with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use cs2764/MiniMax-M2.5_dq4-mlx with MLX:
# Make sure mlx-lm is installed # pip install --upgrade mlx-lm # Generate text with mlx-lm from mlx_lm import load, generate model, tokenizer = load("cs2764/MiniMax-M2.5_dq4-mlx") prompt = "Write a story about Einstein" messages = [{"role": "user", "content": prompt}] prompt = tokenizer.apply_chat_template( messages, add_generation_prompt=True ) text = generate(model, tokenizer, prompt=prompt, verbose=True) - Transformers
How to use cs2764/MiniMax-M2.5_dq4-mlx with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="cs2764/MiniMax-M2.5_dq4-mlx", trust_remote_code=True) messages = [ {"role": "user", "content": "Who are you?"}, ] pipe(messages)# Load model directly from transformers import AutoTokenizer, AutoModelForCausalLM tokenizer = AutoTokenizer.from_pretrained("cs2764/MiniMax-M2.5_dq4-mlx", trust_remote_code=True) model = AutoModelForCausalLM.from_pretrained("cs2764/MiniMax-M2.5_dq4-mlx", trust_remote_code=True) messages = [ {"role": "user", "content": "Who are you?"}, ] inputs = tokenizer.apply_chat_template( messages, add_generation_prompt=True, tokenize=True, return_dict=True, return_tensors="pt", ).to(model.device) outputs = model.generate(**inputs, max_new_tokens=40) print(tokenizer.decode(outputs[0][inputs["input_ids"].shape[-1]:])) - Notebooks
- Google Colab
- Kaggle
- Local Apps
- LM Studio
- vLLM
How to use cs2764/MiniMax-M2.5_dq4-mlx with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "cs2764/MiniMax-M2.5_dq4-mlx" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "cs2764/MiniMax-M2.5_dq4-mlx", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/cs2764/MiniMax-M2.5_dq4-mlx
- SGLang
How to use cs2764/MiniMax-M2.5_dq4-mlx with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "cs2764/MiniMax-M2.5_dq4-mlx" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "cs2764/MiniMax-M2.5_dq4-mlx", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "cs2764/MiniMax-M2.5_dq4-mlx" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "cs2764/MiniMax-M2.5_dq4-mlx", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Pi new
How to use cs2764/MiniMax-M2.5_dq4-mlx with Pi:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "cs2764/MiniMax-M2.5_dq4-mlx"
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": "cs2764/MiniMax-M2.5_dq4-mlx" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use cs2764/MiniMax-M2.5_dq4-mlx 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 "cs2764/MiniMax-M2.5_dq4-mlx"
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 cs2764/MiniMax-M2.5_dq4-mlx
Run Hermes
hermes
- MLX LM
How to use cs2764/MiniMax-M2.5_dq4-mlx with MLX LM:
Generate or start a chat session
# Install MLX LM uv tool install mlx-lm # Interactive chat REPL mlx_lm.chat --model "cs2764/MiniMax-M2.5_dq4-mlx"
Run an OpenAI-compatible server
# Install MLX LM uv tool install mlx-lm # Start the server mlx_lm.server --model "cs2764/MiniMax-M2.5_dq4-mlx" # Calling the OpenAI-compatible server with curl curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "cs2764/MiniMax-M2.5_dq4-mlx", "messages": [ {"role": "user", "content": "Hello"} ] }' - Docker Model Runner
How to use cs2764/MiniMax-M2.5_dq4-mlx with Docker Model Runner:
docker model run hf.co/cs2764/MiniMax-M2.5_dq4-mlx
# Load model directly
from transformers import AutoTokenizer, AutoModelForCausalLM
tokenizer = AutoTokenizer.from_pretrained("cs2764/MiniMax-M2.5_dq4-mlx", trust_remote_code=True)
model = AutoModelForCausalLM.from_pretrained("cs2764/MiniMax-M2.5_dq4-mlx", trust_remote_code=True)
messages = [
{"role": "user", "content": "Who are you?"},
]
inputs = tokenizer.apply_chat_template(
messages,
add_generation_prompt=True,
tokenize=True,
return_dict=True,
return_tensors="pt",
).to(model.device)
outputs = model.generate(**inputs, max_new_tokens=40)
print(tokenizer.decode(outputs[0][inputs["input_ids"].shape[-1]:]))MiniMax-M2.5_dq4
This model is a DQ4 quantized version of the original model MiniMax-M2.5.
It was quantized locally using the mlx_lm library.
Quantization Methodology (DQ4)
This model was quantized using the dynamic DQ4 (4-bit / 5-bit / 6-bit / 8-bit mixed) approach, inspired by the methodology described in the mlx-community/Kimi-K2.5-mlx-DQ3_K_M-q8 repository.
The weights are mixed based on MLX layers:
- Expert layers (switch_mlp / mlp) are quantized to 4-bit.
- The first 5 layers are kept at higher quality (6-bit).
- Every 5th layer is medium quality (5-bit).
- All other layers (e.g. attention, normalization) remain at 8-bit to serve as the "8-bit brain".
- Downloads last month
- 79
4-bit
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="cs2764/MiniMax-M2.5_dq4-mlx", trust_remote_code=True) messages = [ {"role": "user", "content": "Who are you?"}, ] pipe(messages)