MiniMax · 428B (23B active) · MoE

مزيج خبراء متعدّد الوسائط أصلًا — يفهم النص والصورة والفيديو الطويل بسياق مليون رمز. تعرّف على ما إذا كان كرت شاشتك أو جهاز الماك قادرًا على تشغيل MiniMax M3 محليًا — 239.2 جيجابايت كحد أدنى، و398.6 جيجابايت موصى بها.

كيف تستخدم MiniMax M3 في Transformers

حمّل MiniMax M3 في بايثون عبر مكتبة Transformers من HuggingFace. هذه الأوزان الكاملة غير المكمَّمة، فتحتاج ذاكرة أكبر من ملفات GGUF.

عبر pipeline — الطريقة الأسهل

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

pipe = pipeline("image-text-to-text", model="MiniMaxAI/MiniMax-M3", trust_remote_code=True)
messages = [
    {
        "role": "user",
        "content": [
            {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"},
            {"type": "text", "text": "What animal is on the candy?"}
        ]
    },
]
pipe(text=messages)

تحميل النموذج مباشرة

pip install -U transformers
# Load model directly
from transformers import AutoProcessor, AutoModelForMultimodalLM

processor = AutoProcessor.from_pretrained("MiniMaxAI/MiniMax-M3", trust_remote_code=True)
model = AutoModelForMultimodalLM.from_pretrained("MiniMaxAI/MiniMax-M3", trust_remote_code=True, device_map="auto")
messages = [
    {
        "role": "user",
        "content": [
            {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"},
            {"type": "text", "text": "What animal is on the candy?"}
        ]
    },
]
inputs = processor.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(processor.decode(outputs[0][inputs["input_ids"].shape[-1]:]))

التوثيق الرسمي: Transformers

كيف تستخدم MiniMax M3 في llama.cpp

يحمّل llama.cpp ملف MiniMax M3 من HuggingFace مباشرة ويشغّله، إمّا خادمًا متوافقًا مع OpenAI بواجهة ويب أو في الطرفية. اختر مستوى الـ Quantization من القائمة، وتتحدّث الأوامر معه.

ملف GGUF من unsloth/MiniMax-M3-GGUF

التثبيت على macOS وLinux

curl -LsSf https://llama.app/install.sh | sh
# Start a local OpenAI-compatible server with a web UI:
llama serve -hf unsloth/MiniMax-M3-GGUF:UD-Q4_K_XL
# Run inference directly in the terminal:
llama cli -hf unsloth/MiniMax-M3-GGUF:UD-Q4_K_XL

التثبيت عبر WinGet على Windows

winget install llama.cpp
# Start a local OpenAI-compatible server with a web UI:
llama serve -hf unsloth/MiniMax-M3-GGUF:UD-Q4_K_XL
# Run inference directly in the terminal:
llama cli -hf unsloth/MiniMax-M3-GGUF:UD-Q4_K_XL

نسخة جاهزة من صفحة الإصدارات

# Download pre-built binary from:
# https://github.com/ggerganov/llama.cpp/releases
# Start a local OpenAI-compatible server with a web UI:
./llama-server -hf unsloth/MiniMax-M3-GGUF:UD-Q4_K_XL
# Run inference directly in the terminal:
./llama-cli -hf unsloth/MiniMax-M3-GGUF:UD-Q4_K_XL

البناء من الكود المصدري

git clone https://github.com/ggerganov/llama.cpp.git
cd llama.cpp
cmake -B build
cmake --build build -j --target llama-server llama-cli
# Start a local OpenAI-compatible server with a web UI:
./build/bin/llama-server -hf unsloth/MiniMax-M3-GGUF:UD-Q4_K_XL
# Run inference directly in the terminal:
./build/bin/llama-cli -hf unsloth/MiniMax-M3-GGUF:UD-Q4_K_XL

عبر Docker

docker model run hf.co/unsloth/MiniMax-M3-GGUF:UD-Q4_K_XL

التوثيق الرسمي: llama.cpp

كيف تستخدم MiniMax M3 في Ollama

ينزّل Ollama النموذج ويفتح محادثة محلية بأمر واحد. اختر مستوى الـ Quantization من القائمة، وتتحدّث الأوامر معه.

ملف GGUF من unsloth/MiniMax-M3-GGUF

من ملف GGUF على HuggingFace

ollama run hf.co/unsloth/MiniMax-M3-GGUF:UD-Q4_K_XL

التوثيق الرسمي: Ollama

كيف تستخدم MiniMax M3 في Pi

Pi وكيل برمجة يعمل في الطرفية. شغّل MiniMax M3 على خادم llama.cpp محلي ثم وجّه Pi إليه. اختر مستوى الـ Quantization من القائمة، وتتحدّث الأوامر معه.

ملف GGUF من unsloth/MiniMax-M3-GGUF

شغّل خادم llama.cpp

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf unsloth/MiniMax-M3-GGUF:UD-Q4_K_XL

أضف النموذج إلى Pi

# Install Pi:
npm install -g @earendil-works/pi-coding-agent
# Add to ~/.pi/agent/models.json:
{
  "providers": {
    "llama-cpp": {
      "baseUrl": "http://localhost:8080/v1",
      "api": "openai-completions",
      "apiKey": "none",
      "models": [
        {
          "id": "unsloth/MiniMax-M3-GGUF:UD-Q4_K_XL"
        }
      ]
    }
  }
}

شغّل Pi

# Start Pi in your project directory:
pi

التوثيق الرسمي: Pi

كيف تستخدم MiniMax M3 في node-llama-cpp

شغّل MiniMax M3 من Node.js بلا تثبيت مسبق. اختر مستوى الـ Quantization من القائمة، وتتحدّث الأوامر معه.

ملف GGUF من unsloth/MiniMax-M3-GGUF

محادثة مع النموذج

npx -y node-llama-cpp chat hf:unsloth/MiniMax-M3-GGUF:UD-Q4_K_XL

قدّر توافق النموذج مع جهازك

npx -y node-llama-cpp inspect estimate hf:unsloth/MiniMax-M3-GGUF:UD-Q4_K_XL

التوثيق الرسمي: node-llama-cpp

كيف تستخدم MiniMax M3 في Docker Model Runner

يشغّل Docker Desktop النموذج محليًا ويتيحه عبر واجهة متوافقة مع OpenAI. اختر مستوى الـ Quantization من القائمة، وتتحدّث الأوامر معه.

ملف GGUF من unsloth/MiniMax-M3-GGUF

شغّل النموذج

docker model run hf.co/unsloth/MiniMax-M3-GGUF:UD-Q4_K_XL

التوثيق الرسمي: Docker Model Runner

كيف تستخدم MiniMax M3 في LocalAI

LocalAI خادم محلي متوافق مع OpenAI. استبدل {{GGUF_FILE}} باسم ملف GGUF الذي تريده من المستودع unsloth/MiniMax-M3-GGUF.

التثبيت من ملف تنفيذي

curl https://localai.io/install.sh | sh
# Load and run the model:
local-ai run huggingface://unsloth/MiniMax-M3-GGUF/{{GGUF_FILE}}

عبر صور Docker

# Pull the image:
docker pull localai/localai:latest-cpu
# Load and run the model:
docker run -p 8080:8080 --name localai -v $PWD/models:/build/models localai/localai:latest-cpu huggingface://unsloth/MiniMax-M3-GGUF/{{GGUF_FILE}}

التوثيق الرسمي: LocalAI

كيف تستخدم MiniMax M3 في Lemonade

Lemonade خادم محلي من AMD يعمل على المعالجات وكروت الشاشة. اختر مستوى الـ Quantization من القائمة، وتتحدّث الأوامر معه.

ملف GGUF من unsloth/MiniMax-M3-GGUF

نزّل النموذج

# Download Lemonade from https://lemonade-server.ai/
lemonade pull unsloth/MiniMax-M3-GGUF:UD-Q4_K_XL

شغّل النموذج وحاوره

lemonade run user.MiniMax-M3-GGUF-UD-Q4_K_XL

اعرض كل النماذج المتاحة

lemonade list

التوثيق الرسمي: Lemonade

كيف تستخدم MiniMax M3 في Hermes Agent

وكيل Hermes من Nous Research. شغّل MiniMax M3 على خادم llama.cpp محلي ثم وجّه Hermes إليه. اختر مستوى الـ Quantization من القائمة، وتتحدّث الأوامر معه.

ملف GGUF من unsloth/MiniMax-M3-GGUF

شغّل خادم llama.cpp

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf unsloth/MiniMax-M3-GGUF:UD-Q4_K_XL

اضبط 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 unsloth/MiniMax-M3-GGUF:UD-Q4_K_XL

شغّل Hermes

hermes

التوثيق الرسمي: Hermes Agent

كيف تستخدم MiniMax M3 في OpenClaw

OpenClaw وكيل مفتوح المصدر يعمل على جهازك. شغّل MiniMax M3 على خادم llama.cpp محلي ثم سجّله في OpenClaw. اختر مستوى الـ Quantization من القائمة، وتتحدّث الأوامر معه.

ملف GGUF من unsloth/MiniMax-M3-GGUF

شغّل خادم llama.cpp

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf unsloth/MiniMax-M3-GGUF:UD-Q4_K_XL

اضبط 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 "unsloth/MiniMax-M3-GGUF:UD-Q4_K_XL" \
  --custom-provider-id llama-cpp \
  --custom-compatibility openai \
  --custom-text-input \
  --accept-risk \
  --skip-health

شغّل OpenClaw

openclaw agent --local --agent main --message "Hello from Hugging Face"

التوثيق الرسمي: OpenClaw

أوامر التشغيلHuggingFace
2026-06سياق 1024K

MoE

إجمالي الخبراء: 128
الخبراء النشطون: 4
المعاملات النشطة: 23.0B

مستويات الـ Quantization

Quantizationالبتاتالذاكرةالجودةالحالة
Q2_K2137.5GBمنخفضة—
Q3_K_M3192.3GBمتوسطة—
Q4_K_M4219.7GBجيدة—
Q5_K_M5274.5GBجيدة—
Q6_K6329.4GBممتازة—
Q8_08439GBممتازة—
F1616877.4GBبلا فقد—

الأرقام تشمل الأوزان وذاكرة KV عند طول سياق 2K توكن. غيّر طول السياق من لوحة جهازك لترى أثره على الذاكرة والسرعة.

أسئلة شائعة عن تشغيل MiniMax M3 محليًا

هل أستطيع تشغيل MiniMax M3 على جهازي؟
يحتاج MiniMax M3 إلى 239.2 جيجابايت من الذاكرة كحد أدنى، والموصى به 398.6 جيجابايت. يكفي أن تفتح هذه الصفحة ليُقيَّم النموذج تلقائيًا أمام كرت شاشتك أو جهاز الماك، ثم تشغّله عبر Ollama أو LM Studio أو llama.cpp.
كم يحتاج MiniMax M3 من الـ VRAM؟
بتكميم Q4_K_M يستهلك MiniMax M3 نحو 219.7 جيجابايت من ذاكرة الكرت. أما المستويات الأعلى فتحتاج ذاكرة أكبر، والأدنى تناسب الكروت المحدودة مقابل تنازل في الجودة.