Kimi K3

Kimi

Moonshot AI · 2.8T (104B active) · MoE

مزيج خبراء رائد بحجم ٢٫٨ تريليون — ١٠٤ مليار معامل نشط وفهم أصلي للفيديو وسياق مليون رمز. تعرّف على ما إذا كان كرت شاشتك أو جهاز الماك قادرًا على تشغيل Kimi K3 محليًا — 1553.4 جيجابايت كحد أدنى، و2589.1 جيجابايت موصى بها.

كيف تستخدم Kimi K3 في Transformers

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

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

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

pipe = pipeline("feature-extraction", model="moonshotai/Kimi-K3", 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 AutoModel
model = AutoModel.from_pretrained("moonshotai/Kimi-K3", trust_remote_code=True, device_map="auto")

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

كيف تستخدم Kimi K3 في llama.cpp

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

ملف GGUF من unsloth/Kimi-K3-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/Kimi-K3-GGUF:UD-Q4_K_XL
# Run inference directly in the terminal:
llama cli -hf unsloth/Kimi-K3-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/Kimi-K3-GGUF:UD-Q4_K_XL
# Run inference directly in the terminal:
llama cli -hf unsloth/Kimi-K3-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/Kimi-K3-GGUF:UD-Q4_K_XL
# Run inference directly in the terminal:
./llama-cli -hf unsloth/Kimi-K3-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/Kimi-K3-GGUF:UD-Q4_K_XL
# Run inference directly in the terminal:
./build/bin/llama-cli -hf unsloth/Kimi-K3-GGUF:UD-Q4_K_XL

عبر Docker

docker model run hf.co/unsloth/Kimi-K3-GGUF:UD-Q4_K_XL

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

كيف تستخدم Kimi K3 في Ollama

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

ملف GGUF من unsloth/Kimi-K3-GGUF

من ملف GGUF على HuggingFace

ollama run hf.co/unsloth/Kimi-K3-GGUF:UD-Q4_K_XL

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

كيف تستخدم Kimi K3 في Pi

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

ملف GGUF من unsloth/Kimi-K3-GGUF

شغّل خادم llama.cpp

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf unsloth/Kimi-K3-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/Kimi-K3-GGUF:UD-Q4_K_XL"
        }
      ]
    }
  }
}

شغّل Pi

# Start Pi in your project directory:
pi

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

كيف تستخدم Kimi K3 في node-llama-cpp

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

ملف GGUF من unsloth/Kimi-K3-GGUF

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

npx -y node-llama-cpp chat hf:unsloth/Kimi-K3-GGUF:UD-Q4_K_XL

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

npx -y node-llama-cpp inspect estimate hf:unsloth/Kimi-K3-GGUF:UD-Q4_K_XL

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

كيف تستخدم Kimi K3 في Docker Model Runner

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

ملف GGUF من unsloth/Kimi-K3-GGUF

شغّل النموذج

docker model run hf.co/unsloth/Kimi-K3-GGUF:UD-Q4_K_XL

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

كيف تستخدم Kimi K3 في LocalAI

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

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

curl https://localai.io/install.sh | sh
# Load and run the model:
local-ai run huggingface://unsloth/Kimi-K3-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/Kimi-K3-GGUF/{{GGUF_FILE}}

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

كيف تستخدم Kimi K3 في Lemonade

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

ملف GGUF من unsloth/Kimi-K3-GGUF

نزّل النموذج

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

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

lemonade run user.Kimi-K3-GGUF-UD-Q4_K_XL

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

lemonade list

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

كيف تستخدم Kimi K3 في Hermes Agent

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

ملف GGUF من unsloth/Kimi-K3-GGUF

شغّل خادم llama.cpp

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf unsloth/Kimi-K3-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/Kimi-K3-GGUF:UD-Q4_K_XL

شغّل Hermes

hermes

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

كيف تستخدم Kimi K3 في OpenClaw

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

ملف GGUF من unsloth/Kimi-K3-GGUF

شغّل خادم llama.cpp

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf unsloth/Kimi-K3-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/Kimi-K3-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-07سياق 1024K

MoE

إجمالي الخبراء: 896
الخبراء النشطون: 16
المعاملات النشطة: 104.2B

مستويات الـ Quantization

Quantizationالبتاتالذاكرةالجودةالحالة
Q2_K2890.5GBمنخفضة—
Q3_K_M31246.5GBمتوسطة—
Q4_K_M41424.5GBجيدة—
Q5_K_M51780.5GBجيدة—
Q6_K62136.5GBممتازة—
Q8_082848.5GBممتازة—
F16165696.5GBبلا فقد—

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

أسئلة شائعة عن تشغيل Kimi K3 محليًا

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