Instructions to use tiny-random/minimax-m2.5 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use tiny-random/minimax-m2.5 with Transformers:

# Use a pipeline as a high-level helper
from transformers import pipeline

pipe = pipeline("text-generation", model="tiny-random/minimax-m2.5", 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("tiny-random/minimax-m2.5", trust_remote_code=True)
model = AutoModelForCausalLM.from_pretrained("tiny-random/minimax-m2.5", 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

vLLM

How to use tiny-random/minimax-m2.5 with vLLM:

Install from pip and serve model

# Install vLLM from pip:
pip install vllm
# Start the vLLM server:
vllm serve "tiny-random/minimax-m2.5"
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:8000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "tiny-random/minimax-m2.5",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

Use Docker

docker model run hf.co/tiny-random/minimax-m2.5

SGLang

How to use tiny-random/minimax-m2.5 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 "tiny-random/minimax-m2.5" \
    --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": "tiny-random/minimax-m2.5",
		"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 "tiny-random/minimax-m2.5" \
        --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": "tiny-random/minimax-m2.5",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

Docker Model Runner
How to use tiny-random/minimax-m2.5 with Docker Model Runner:
```
docker model run hf.co/tiny-random/minimax-m2.5
```

minimax-m2.5 / README.md

yujiepan

Upload folder using huggingface_hub

e9a82a2 verified 3 months ago

preview code

raw

history blame contribute delete

5.93 kB

metadata

library_name: transformers
base_model:
  - MiniMaxAI/MiniMax-M2.5

This tiny model is intended for debugging. It is randomly initialized using the configuration adapted from MiniMaxAI/MiniMax-M2.5.

File path	Size
model.safetensors	7.1MB

Example usage:

vLLM

vllm serve tiny-random/minimax-m2.5 --trust-remote-code --reasoning-parser minimax_m2_append_think --enable-auto-tool-choice --tool-call-parser minimax_m2

Transformers

import torch
from transformers import AutoModelForCausalLM, AutoTokenizer, pipeline

model_id = "tiny-random/minimax-m2.5"
tokenizer = AutoTokenizer.from_pretrained(model_id, trust_remote_code=True)
model = AutoModelForCausalLM.from_pretrained(
    model_id,
    dtype=torch.bfloat16,
    trust_remote_code=True,
)
pipe = pipeline('text-generation', model=model,
                tokenizer=tokenizer, trust_remote_code=True)
print(pipe('Write an article about Artificial Intelligence.', max_new_tokens=16))

Codes to create this repo:

Click to expand

import json
from pathlib import Path

import accelerate
import torch
import transformers
from huggingface_hub import file_exists, hf_hub_download
from transformers import (
    AutoConfig,
    AutoModelForCausalLM,
    AutoTokenizer,
    GenerationConfig,
    set_seed,
)
# try:
#     from transformers.utils.output_capturing import OutputRecorder, capture_outputs
#     transformers.utils.generic.OutputRecorder = OutputRecorder
#     transformers.utils.generic.capture_outputs = capture_outputs
#     transformers.utils.generic.check_model_inputs = capture_outputs
#     transformers.modeling_rope_utils.ROPE_INIT_FUNCTIONS['default'] = transformers.modeling_rope_utils.ROPE_INIT_FUNCTIONS['linear']
# except ImportError:
#     pass

source_model_id = "MiniMaxAI/MiniMax-M2.5"
save_folder = "/tmp/tiny-random/minimax-m25"

processor = AutoTokenizer.from_pretrained(source_model_id)
processor.save_pretrained(save_folder)

with open(hf_hub_download(source_model_id, filename='config.json', repo_type='model'), 'r', encoding='utf-8') as f:
    config_json = json.load(f)

config_json["attn_type_list"] = [1, 1]
# del config_json['auto_map']
# del config_json['num_mtp_modules']
for k, v in config_json['auto_map'].items():
    config_json['auto_map'][k] = f'{source_model_id}--{v}'

config_json['head_dim'] = 32
config_json['hidden_size'] = 8
config_json['intermediate_size'] = 32
config_json['num_attention_heads'] = 8
config_json['num_key_value_heads'] = 4
config_json['num_hidden_layers'] = 2
config_json['mlp_intermediate_size'] = 32
# config_json['num_local_experts'] = 32
config_json['rotary_dim'] = 16
del config_json['quantization_config']

with open(f"{save_folder}/config.json", "w", encoding='utf-8') as f:
    json.dump(config_json, f, indent=2)

config = AutoConfig.from_pretrained(
    save_folder,
    trust_remote_code=True,
)
# config.standardize_rope_params()
# config.rope_parameters['rope_type'] = 'linear'
# config.rope_parameters['factor'] = 1.0
torch.set_default_dtype(torch.bfloat16)
model = AutoModelForCausalLM.from_config(config, trust_remote_code=True)
torch.set_default_dtype(torch.float32)
print(model)

# according to source model, gate is in FP32
for i in range(config.num_hidden_layers):
    model.model.layers[i].block_sparse_moe.gate = model.model.layers[i].block_sparse_moe.gate.float()
    model.model.layers[i].block_sparse_moe.e_score_correction_bias = model.model.layers[i].block_sparse_moe.e_score_correction_bias.float()
if file_exists(filename="generation_config.json", repo_id=source_model_id, repo_type='model'):
    model.generation_config = GenerationConfig.from_pretrained(
        source_model_id, trust_remote_code=True,
    )
set_seed(42)
model = model.cpu()
with torch.no_grad():
    for name, p in sorted(model.named_parameters()):
        torch.nn.init.normal_(p, 0, 0.1)
        print(name, p.shape)
model.save_pretrained(save_folder)
print(model)

automap = config_json['auto_map']
with open(f"{save_folder}/config.json", "r", encoding='utf-8') as f:
    config_json = json.load(f)
    config_json['auto_map'] = automap
with open(f"{save_folder}/config.json", "w", encoding='utf-8') as f:
    json.dump(config_json, f, indent=2)
for python_file in Path(save_folder).glob('*.py'):
    python_file.unlink()

Printing the model:

Click to expand

MiniMaxM2ForCausalLM(
  (model): MiniMaxM2Model(
    (embed_tokens): Embedding(200064, 8)
    (layers): ModuleList(
      (0-1): 2 x MiniMaxM2DecoderLayer(
        (self_attn): MiniMaxM2Attention(
          (q_proj): Linear(in_features=8, out_features=256, bias=False)
          (k_proj): Linear(in_features=8, out_features=128, bias=False)
          (v_proj): Linear(in_features=8, out_features=128, bias=False)
          (o_proj): Linear(in_features=256, out_features=8, bias=False)
          (q_norm): MiniMaxM2RMSNorm((256,), eps=1e-06)
          (k_norm): MiniMaxM2RMSNorm((128,), eps=1e-06)
        )
        (block_sparse_moe): MiniMaxM2SparseMoeBlock(
          (gate): Linear(in_features=8, out_features=256, bias=False)
          (experts): MiniMaxM2Experts(
            (0-255): 256 x MiniMaxM2MLP(
              (w1): Linear(in_features=8, out_features=32, bias=False)
              (w2): Linear(in_features=32, out_features=8, bias=False)
              (w3): Linear(in_features=8, out_features=32, bias=False)
              (act_fn): SiLUActivation()
            )
          )
        )
        (input_layernorm): MiniMaxM2RMSNorm((8,), eps=1e-06)
        (post_attention_layernorm): MiniMaxM2RMSNorm((8,), eps=1e-06)
      )
    )
    (norm): MiniMaxM2RMSNorm((8,), eps=1e-06)
    (rotary_emb): MiniMaxM2RotaryEmbedding()
  )
  (lm_head): Linear(in_features=8, out_features=200064, bias=False)
)