الخلاصة
Kimi K3 بوزن مفتوح وليس بمقياس محطة عمل: تشغيل النموذج الأصلي يتطلب وحدات GPU من فئة مراكز البيانات وذاكرة موزعة. استخدم vLLM لأقصر طريق إلى الإنتاج مباشرة، أو SGLang عندما تهمك الطوبولوجيا والتوازي بين الخبراء والتحكم في الذاكرة المؤقتة. تعمل إصدارات GGUF المجتمعية على خفض عتبة العتاد، لكنها ما تزال تتطلب نحو 500 GB إلى أكثر من 1 TB بكثير من الذاكرة القابلة للعنونة وتبادل السرعة أو الجودة مقابل إمكانية التشغيل. لأجهزة الكمبيوتر الشخصية وأجهزة Mac العادية، اختبر أولاً عبر واجهة API مستضافة ثم استضف ذاتيًا فقط عندما تبرر الخصوصية أو الاستفادة المستدامة أو التحكم في البنية التحتية التكلفة.
ما هو Kimi K3؟
Kimi K3 هو نموذج Moonshot AI الرائد متعدد الوسائط بوزن مفتوح، مصمم للعمل على الأمد الطويل في البرمجة، وأعمال المعرفة العاملية، والاستدلال، وفهم الرؤية.
تصفه Moonshot بأنه أول نموذج مفتوح من فئة 3T في العالم. تجمع بنيته بين Kimi Delta Attention وAttention Residuals وتصميم MoE متفرق يختار فقط مجموعة فرعية من الخبراء لكل رمز.
الحجم غير اعتيادي حتى وفق معايير نماذج الطليعة. بدلاً من تفعيل كل معاملات 2.8T لكل رمز، ينتقي K3 16 من أصل 896 خبيرًا موجّهًا، بالإضافة إلى خبراء مشتركين. هذا يقلل الحساب لكل رمز بشكل كبير، مع أن جميع أوزان النموذج ما تزال بحاجة لأن تكون متاحة في مكان ما ضمن نظام الاستدلال.
| المواصفات | Kimi K3 — المواصفات الرسمية للنموذج |
|---|---|
| البنية | مزيج الخبراء (MoE) |
| إجمالي المعاملات | 2.8T |
| المعاملات المُفعّلة | 104B |
| عدد الخبراء | 896 |
| الخبراء المختارون لكل رمز | 16 |
| طول السياق | 1,048,576 رمزًا |
| مشفّر الرؤية | MoonViT-V2 |
| التكميم الأصلي | MXFP4 weights / MXFP8 activations |
| أنماط بطاقة النموذج الرسمية | نص + صورة |
يطبق K3 أيضًا تدريبًا واعيًا بالتكميم بدءًا من مرحلة SFT بدل التعامل مع تقديم الدقة المنخفضة كخطوة ضغط بعد التدريب فقط.
لهذا تم تحسين بنيته لخدمة واسعة النطاق جدًا—لكن لا ينبغي الخلط بين “الحوسبة المتفرقة” و”بصمة الذاكرة الصغيرة”. جزء فقط من الشبكة يحسب كل رمز، لكن حوض الخبراء الكامل يجب أن يظل متاحًا.
كيف يؤدي Kimi K3؟
تضع مجموعة تقييمات Kimi K3 الرسمية من Moonshot المعلنة هنا النموذج قريبًا من نماذج الطليعة المغلقة الرائدة، خصوصًا في هندسة البرمجيات طويلة الأمد والأعمال العاملية.
يغطي الاختيار التالي الاستدلال والبرمجة والوكلاء والرؤية. الأعلى أفضل لجميع الدرجات المعروضة.
| التقييم — نتائج Moonshot الرسمية | Kimi K3 | GPT-5.6 Sol | Claude Fable 5 | Claude Opus 4.8 |
|---|---|---|---|---|
| GPQA Diamond | 93.5 | 94.1 | 92.6 | 91.0 |
| ProgramBench | 77.8 | 77.6 | 76.8 | 71.9 |
| Terminal-Bench 2.1 | 88.3 | 88.8 | 88.0 | 84.6 |
| FrontierSWE | 81.2 | 71.3 | 86.6 | 66.7 |
| SWE-Marathon | 42.0 | 39.0 | 35.0 | 40.0 |
| BrowseComp | 91.2 | 90.4 | 88.0 | 84.3 |
| OmniDocBench | 91.1 | 85.8 | 89.8 | 87.9 |
| PerceptionBench | 58.5 | 59.7 | 57.2 | 47.2 |
تضع الدرجات الرسمية Kimi K3 بالقرب من GPT-5.6 Sol وClaude Fable 5 وClaude Opus 4.8 عبر مهام الاستدلال والبرمجة والوكلاء والرؤية. تعامل مع هذه النتائج المعلنة من المزود كإطار قدرات وليس ترتيبًا عالميًا؛ يتم تناول تحليل التقييم التفصيلي بشكل منفصل. نقطة التشغيل هنا هي أن الاستضافة الذاتية توفر قدرات من فئة الطليعة وتحكمًا في البنية التحتية، لكنها ليست اختصارًا منخفض التكلفة لسطح المكتب.
هل يمكنك فعليًا تشغيل Kimi K3 محليًا؟
نعم، لكن هناك تعريفين مختلفين جدًا لكلمة “محلي”.
- خادم محلي / مركز بيانات خاص: واقعي.
- سطح مكتب أو لابتوب عادي: ممكن تقنيًا بإصدارات مجتمعية مكثفة التكميم، لكنه غير عملي عمومًا للاستخدام التفاعلي.
يحدد إعداد vLLM الحالي لـ Kimi K3 خط أساس مرتفعًا جدًا:
- NVIDIA: على الأقل 8× GB300
- AMD ROCm: على الأقل 8× MI355X أو MI350X
- تعريف NVIDIA: R580+ لصورة CUDA 13 الحالية الخاصة بـ K3
- يُوصى بالبنية متعددة العقد لحركة الإنتاج الفعلية
كما عرض دليل vLLM في اليوم 0 مسار تشغيل سريع على 8 بطاقات B300 أو 8 بطاقات MI355X. لعملية نشر إنتاجية جديدة، اتبع الوصفة الأحدث لأنها تعكس حزمة الخدمة بعد تحسينات يوم الإطلاق.
هذه هي النقطة الأساسية: K3 بوزن مفتوح، لكنه ليس نموذجًا بمقياس المستهلك.
الأوزان الرسمية مقابل تكميم GGUF المجتمعي
هناك طريقة أخرى لخفض عتبة العتاد: التكميم المجتمعي.
يوفر مستودع Unsloth K3 الحالي عدة نسخ GGUF يمكن تشغيلها عبر برمجيات متوافقة مع llama.cpp.
مقارنة موحدة. أرقام الذاكرة القابلة للعنونة هي تقديرات تخطيطية (حجم التنزيل زائد نحو 10–15% هامش تشغيل) وليست ضمانات؛ قد تتطلب إعدادات السياق والذاكرة المؤقتة والرؤية والتفريغ المزيد.
| المتغير | التحميل | الذاكرة القابلة للعنونة المقترحة | دعم الرؤية | وقت التشغيل الموثّق | الهدف / أدلة الجودة |
|---|---|---|---|---|---|
| UD-Q1_0 | 466 GB | ≥520 GB | يذكر المستودع دعم الرؤية؛ تحقق من مسار التشغيل المطابق. | فرع PR لـ Unsloth على llama.cpp؛ مسار Ollama موثّق بإصدار غير مثبت. | إثبات إمكانية؛ لا اختبار جودة مستقل خاص بالمتغير مذكور. |
| UD-TQ1_0 | 509 GB | ≥570 GB | نفس ملاحظة دعم الرؤية على مستوى المستودع. | نفس مسار التشغيل الموثّق. | تجربة فئة 1-بت عدوانية؛ لا اختبار جودة مستقل خاص بالمتغير مذكور. |
| UD-IQ1_S | 594 GB | ≥665 GB | نفس ملاحظة دعم الرؤية على مستوى المستودع. | نفس مسار التشغيل الموثّق. | تجربة محلية قصوى؛ لا اختبار جودة مستقل خاص بالمتغير مذكور. |
| UD-IQ1_M | 649 GB | ≥730 GB | نفس ملاحظة دعم الرؤية على مستوى المستودع. | نفس مسار التشغيل الموثّق. | تسوية 1-بت أعلى جودة؛ لا اختبار جودة مستقل خاص بالمتغير مذكور. |
| UD-IQ2_XXS | 711 GB | ≥800 GB | نفس ملاحظة دعم الرؤية على مستوى المستودع. | نفس مسار التشغيل الموثّق. | تجربة فئة 2-بت؛ لا اختبار جودة مستقل خاص بالمتغير مذكور. |
| UD-Q2_K_XL | 861 GB | ≥970 GB | نفس ملاحظة دعم الرؤية على مستوى المستودع. | نفس مسار التشغيل الموثّق. | خادم CPU/GPU كبير؛ لا اختبار جودة مستقل خاص بتكميم K3 مذكور. |
| UD-Q4_K_XL | 1.51 TB | ≥1.7 TB | نفس ملاحظة دعم الرؤية على مستوى المستودع. | أمثلة llama.cpp وOllama مباشرة موثّقة لهذا المتغير. | تقديم GGUF يركز على الجودة؛ لا تقييم مستقل لتكميم K3 مذكور. |
| UD-Q8_K_XL | 1.56 TB | ≥1.75 TB | نفس ملاحظة دعم الرؤية على مستوى المستودع. | نفس مسار التشغيل الموثّق. | بناء مجتمعي شبه عديم الفقد؛ فائدة تخزين قليلة مقارنة بـ Q4. |
هذا التفريق يفسر أيضًا لماذا ذكرت بعض مقالات النشر المحلية المبكرة 594 GB: 594 GB تشير الآن إلى بناء UD-IQ1_S GGUF المجتمعي، وليس وصفًا مفيدًا لنقطة التحقق الأصلية الحالية الكاملة.
نموذج بحجم 466–649 GB أصغر بكثير من بصمة النشر الأصلية، لكنه ما يزال ضخمًا بمعايير محطات العمل. يجب أيضًا ترك ذاكرة لحالة وقت التشغيل والسياق والذاكرات المؤقتة ومسقِّط الرؤية وعمليات نظام التشغيل وغير ذلك من الحمل.
سعة القرص ليست مساوية لذاكرة الاستدلال. امتلاك SSD بسعة 1 TB لا يعني أن نموذج 600 GB سيعمل بسرعة على جهاز بذاكرة RAM سعة 64 GB. قد يجعل التفريغ إلى SSD التجارب القصوى ممكنة تقنيًا، لكن توليد الرموز قد يصبح بطيئًا للغاية.
كيفية نشر Kimi K3 باستخدام vLLM
للاستضافة الذاتية الجادة، يعد vLLM نقطة البداية الأكثر مباشرة.
تسرد Moonshot حاليًا vLLM كأحد محركات استدلال K3 الموصى بها، كما يقدم vLLM دعمًا خاصًا لـ KDA وMXFP4 MoE وتحليل الاستدلال واستدعاء الأدوات وتخزين البوادئ المؤقت والتوزيع.
تحقق من المتطلبات الأساسية
للنشر الإنتاجي على NVIDIA، تستخدم الوصفة المختبرة الحالية الحاوية vllm/vllm-openai:kimi-k3.
تحقق من وحدات GPU:
nvidia-smi
تأكد من Docker:
docker --version
تأكد من أن NVIDIA Container Toolkit يرى المسرّعات:
docker run --rm --gpus all nvidia/cuda:13.0.0-base-ubuntu24.04 nvidia-smi
إذا لم يستطع الأمر الأخير رؤية جميع وحدات GPU، أصلح بيئة تشغيل GPU على المضيف/الحاوية قبل تنزيل نموذج متعدد التيرابايت.
عيّن رمز Hugging Face
إذا كانت المصادقة مطلوبة لمستودع النموذج، خزّن الرمز في متغير بيئة بدلًا من تثبيته في السكربتات.
export HF_TOKEN="YOUR_HUGGING_FACE_TOKEN"
اسحب حاوية vLLM الخاصة بـ K3
docker pull vllm/vllm-openai:kimi-k3
تحدد الوصفة الحالية بناء CUDA 13 وتعريف NVIDIA بإصدار R580 أو أحدث.
تشغيل Kimi K3
قالب بدء تشغيل Blackwell TP8 الحالي (وصفة vLLM محدّثة في 2026-09-10): استخدمه كخط أساس، ثم أعد التوليد أو اختبر الأداء لعتادك وحركة المرور لديك بالضبط.
docker run --rm \
--gpus all \
--ipc=host \
-p 8000:8000 \
-v ~/.cache/huggingface:/root/.cache/huggingface \
-e HF_TOKEN="$HF_TOKEN" \
-e VLLM_USE_V2_MODEL_RUNNER=1 \
vllm/vllm-openai:kimi-k3 \
--model moonshotai/Kimi-K3 \
--tensor-parallel-size 8 \
--gpu-memory-utilization 0.95 \
--kv-cache-dtype fp8 \
--attention-backend TOKENSPEED_MLA \
--attention-config '{"use_prefill_query_quantization":true,"mla_prefill_backend":"TOKENSPEED_MLA"}' \
--prefix-match-unit 128 \
--enable-prefix-caching \
--max-model-len 131072 \
--enable-auto-tool-choice \
--tool-call-parser kimi_k3 \
--reasoning-parser kimi_k3
تتطلب الوصفة الحالية صورة K3 لـ CUDA 13 وتعريف NVIDIA بإصدار R580 أو أحدث. يجب إقران ذاكرة KV المؤقتة بدقة FP8 مع خلفية MLA متوافقة للتهيئة/الفك؛ اختبر بدائل الانتباه قبل تغيير الإعداد.
المصدر: وصفة vLLM لـ Kimi K3. هذا يستبدل أمر اليوم 0 السابق بدل تقديمه كالوصفة الإنتاجية الحالية.
لأول تشغيل تحقق، فكّر في تقليل الحد الأقصى لطول النموذج بدلًا من تخصيص القدرة كاملة البالغة 1,048,576 رمزًا فورًا. توصي وصفة vLLM الحالية صراحةً بضبط max-model-len وفق عبء العمل.
على سبيل المثال:
--max-model-len 131072
هذا لا يغيّر حد السياق المعماري لـ K3. إنه فقط يمنح محرك الخدمة نطاق تشغيل أكثر قابلية للإدارة لاختباراتك الأولية.
اختبار نقطة النهاية المحلية
يعرض vLLM واجهة API متوافقة مع OpenAI على المنفذ 8000.
curl http://localhost:8000/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{
"model": "moonshotai/Kimi-K3",
"messages": [
{
"role": "user",
"content": "Explain the difference between tensor parallelism and expert parallelism."
}
],
"max_tokens": 512
}'
أو استخدم OpenAI Python SDK:
python
from openai import OpenAI
client = OpenAI(
base_url="http://localhost:8000/v1",
api_key="EMPTY",
timeout=3600,
)
response = client.chat.completions.create(
model="moonshotai/Kimi-K3",
messages=[
{
"role": "user",
"content": "Write a Python function that validates a JSON schema.",
}
],
max_tokens=1024,
)
print(response.choices[0].message.content)
تستخدم الوصفة الرسمية لـ vLLM نفس نمط localhost المتوافق مع OpenAI، ما يجعل تبديل التطبيق بين الاستدلال المحلي والمستضاف أمرًا سهلًا نسبيًا.
كيفية نشر Kimi K3 باستخدام SGLang
SGLang هو المسار الآخر الرئيسي للنشر الذي توصي به Moonshot رسميًا.
يصبح ذا صلة خاصة عندما تريد تحكمًا أعمق في الخدمة الموزعة، والتوازي بين الخبراء، وأنوية خاصة بالعتاد، أو طوبولوجيا إنتاج معقدة.
استخدم كتاب الطهي المخصص لـ SGLang الخاص بـ Kimi K3 واختر طوبولوجيا خاصة بالعتاد. التالي هو ملف تعريف Unified/Balanced مؤكد لعقدة واحدة 8×B300 من كتاب الطهي؛ تم قياسه باستخدام SGLang v0.5.18 على الالتزام 71de97b2.
ثبّت بناءً يدعم K3:
pip install --upgrade pip
pip install uv
uv pip install --prerelease=allow sglang
شغّل ملف تعريف B300 TP8/DCP8 المؤكّد:
sglang serve \
--trust-remote-code \
--model-path moonshotai/Kimi-K3 \
--tp-size 8 \
--dcp-size 8 \
--mem-fraction-static 0.85 \
--mamba-full-memory-ratio <value-from-official-calculator> \
--reasoning-parser kimi_k3 \
--tool-call-parser kimi_k3 \
--host 0.0.0.0 \
--port 30000
تتعلق قيمة --mamba-full-memory-ratio بعبء العمل: احسبها من متوسط طول الإدخال زائد الإخراج في كتاب الطهي الرسمي. لا تنسخ هذه الطوبولوجيا الخاصة بـ B300 إلى H100/H200 أو GB200/GB300 أو AMD أو عمليات نشر متعددة العقد؛ تستخدم تلك ملفات TP/PP/DCP/EP مختلفة.
اختبر الخادم:
curl http://localhost:30000/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{
"model": "moonshotai/Kimi-K3",
"messages": [{"role": "user", "content": "Give me a five-step debugging plan for a distributed Python application."}]
}'
لنشر حقيقي، تحقق من السعة وجودة المخرجات واسترداد الأعطال على إصدار SGLang نفسه والطوبولوجيا وطول السياق ومزيج الحركة الذي تنوي تشغيله.
vLLM مقابل SGLang مقابل llama.cpp
يعتمد اختيار محرك الاستدلال أساسًا على عتادك وهدف النشر.
| طريقة النشر | فئة العتاد | الأوزان الأصلية الرسمية | واجهة API متوافقة مع OpenAI | إنتاج موزع | سهولة الإعداد | أفضل ملاءمة |
|---|---|---|---|---|---|---|
| vLLM | عنقود GPU لفئة مراكز البيانات | نعم | نعم | ممتاز | متوسطة | خيار الإنتاج الافتراضي |
| SGLang | عنقود GPU لفئة مراكز البيانات | نعم | نعم | ممتاز | متوسطة–عالية | خدمة موزعة متقدمة |
| llama.cpp + GGUF | محطة عمل/خادم بذاكرة ضخمة | تكميم مجتمعي | نعم | محدود مقارنة بـ vLLM/SGLang | منخفضة–متوسطة | تجارب محلية |
| Ollama + GGUF | محطة عمل/خادم بذاكرة ضخمة | تكميم مجتمعي | نعم | ليس الهدف الأساسي | سهلة | اختبار يفضل السهولة |
| CometAPI | لا تتطلب GPU محليًا | مستضافة | نعم | مُدارة | سهلة جدًا | مطورون بلا عتاد من فئة K3 |
إذا كنت تملك خادمًا بـ 8 وحدات GPU من فئة Blackwell/MI35x، فابدأ مع vLLM.
إذا كنت تصمم عنقود استدلال موزعًا متخصصًا وتريد مزيدًا من تحكم الخدمة منخفض المستوى، فقَيِّم SGLang أيضًا.assistant_message
إذا كان هدفك ببساطة “أريد إثبات أن K3 يمكنه التنفيذ على العتاد الذي أملكه”، فإن GGUF مع llama.cpp أكثر قابلية—بشرط أن تمتلك جهازًا بذاكرة استثنائية حقًا.
كيفية تشغيل Kimi K3 مُكمّمًا باستخدام llama.cpp أو Ollama
يوفر مستودع Kimi K3 GGUF المجتمعي الآن نسخًا متوافقة مع llama.cpp.
يخفض هذا المسار حاجز الدخول بشكل كبير مقارنة بنشر الأوزان الأصلية لفئة مراكز البيانات، لكن “بشكل كبير” أمر نسبي: حتى الإصدارات الأصغر هي بمئات الجيجابايت.
تثبيت llama.cpp على macOS أو Linux
يوفر كرت النموذج GGUF الحالي:
curl -LsSf https://llama.app/install.sh | sh
على Windows:
winget install llama.cpp
بدء خادم متوافق مع OpenAI
يوثق المستودع حاليًا UD-Q4_K_XL كمثال:
llama serve \
-hf unsloth/Kimi-K3-GGUF:UD-Q4_K_XL
يمكنك أيضًا تشغيل CLI مباشرة:
llama cli \
-hf unsloth/Kimi-K3-GGUF:UD-Q4_K_XL
تأتي هذه الأوامر مباشرة من كرت نموذج Kimi K3 GGUF الحالي.
إلا أن UD-Q4_K_XL يبلغ نحو 1.51 TB، لذا ليس المتغير الذي سيبدأ به معظم مستخدمي محطات العمل. إذا كانت أولويتك تقليل متطلبات الذاكرة بدل الحفاظ على أكبر قدر ممكن من الجودة، فافحص أولًا متغيرات 1-بت و2-بت الأصغر.
على سبيل المثال:
llama serve \
-hf unsloth/Kimi-K3-GGUF:UD-IQ1_M
يبلغ دليل UD-IQ1_M الحالي تقريبًا 649 GB.
ما يزال نموذج 649 GB بعيدًا عن كونه نموذجًا للابتوب العادي. من المثالي أن تقيم حالة النموذج كثير الاستخدام في ذاكرة سريعة. قد يجعل التفريغ الكثيف إلى SSD التجربة القصوى ممكنة تقنيًا دون جعلها مفيدة للعمل التفاعلي.
تشغيل نفس بناء GGUF بواسطة Ollama
Ollama هو طبقة راحة لمسار النشر نفسه عبر GGUF، وليس طريقة استضافة ذاتية رابعة مستقلة.
يعرض مستودع K3 GGUF أيضًا مسار Ollama.
على سبيل المثال:
bash
ollama run hf.co/unsloth/Kimi-K3-GGUF:UD-Q4_K_XL
يبسط Ollama إدارة النماذج وتجربة واجهة API، لكنه لا يغيّر متطلبات الذاكرة الخاصة بـ K3.
تغيير المُشغّل من llama.cpp إلى Ollama لا يمكنه تحويل تكميم بحجم عدة مئات الجيجابايت إلى نموذج GPU بسعة 24 GB. لا بد من تخزين بيانات النموذج الأساسية والوصول إليها.
لهذا السبب، من الأفضل النظر إلى Ollama على أنه غلاف تشغيل مريح، وليس حلاً لتجاوز العتاد.
ما أفضل تكميم Kimi K3 الذي ينبغي اختياره؟
للتجارب، يكون الاختيار في الأساس مقايضة بين حجم النموذج والوفاء.
| خيارات تكميم GGUF | الحجم | ضغط الذاكرة النسبي | توقع الجودة | الاستخدام الموصى به |
|---|---|---|---|---|
| UD-Q1_0 | 466 GB | الأدنى | مخاطر تدهور أعلى | إثبات إمكانية |
| UD-IQ1_S | 594 GB | عالٍ جدًا | عدواني | تجارب محلية قصوى |
| UD-IQ1_M | 649 GB | عالٍ جدًا | تسوية 1-بت أفضل | خادم تجريبي بذاكرة كبيرة |
| UD-Q2_K_XL | 861 GB | بالغ الشدة | وفاء أفضل | خادم CPU/GPU كبير |
| UD-Q4_K_XL | 1.51 TB | فئة مراكز البيانات | وفاء أعلى | استضافة ذاتية تركز على الجودة |
| تقديم K3 الأصلي | فئة مراكز البيانات | فئة مراكز البيانات | سلوك النموذج المقصود | الإنتاج |
سلوك مهم في تقديم Kimi K3
هناك تفصيلة تنفيذ خاصة بـ K3 يسهل تجاهلها.
يستخدم K3 سجل تفكير محفوظ. تقول Moonshot إن المحادثات متعددة الأدوار وتدفقات استدعاء الأدوات يجب أن تُعيد إرسال رسالة المساعد السابقة كاملةً إلى النموذج، بما في ذلك reasoning_content وtool_calls، بدلًا من الاحتفاظ بالمحتوى المرئي فقط.
نمط تطبيق مبسط يبدو كالتالي:
messages = [
{
"role": "user",
"content": "Inspect this project and propose a migration plan.",
}
]
first = client.chat.completions.create(
model="moonshotai/Kimi-K3",
messages=messages,
max_tokens=2048,
)
assistant_message = first.choices[0].message
# Preserve the whole message object, not just assistant_message.content.
messages.append(
assistant_message.model_dump(exclude_none=True)
)
messages.append(
{
"role": "user",
"content": "Now identify the riskiest part of that plan.",
}
)
second = client.chat.completions.create(
model="moonshotai/Kimi-K3",
messages=messages,
max_tokens=2048,
)
يصبح هذا مهمًا بشكل خاص لوكلاء البرمجة وحلقات الأدوات والجلسات المستقلة طويلة التشغيل.
يبقي K3 الاستدلال مُمكّنًا ويدعم جهد استدلال منخفض وعالٍ وأقصى. عندما تعرض طبقة الخدمة تلك المعلمات، تعامل مع جهد الاستدلال كعنصر للتحكم في زمن الاستجابة/الجودة بدل تعظيمه دائمًا لكل طلب.
كيفية تحسين نشر Kimi K3 محليًا
لا تخصّص سياق 1M كاملًا فورًا
يدعم K3 1,048,576 رمزًا، لكن الحد الأقصى لقدرة النموذج والتكوين المعقول للخادم شيئان مختلفان.
للتطوير، ابدأ مثلًا بـ:
--max-model-len 131072
ثم زد السياق فقط بعد قياس الذاكرة المتاحة، وزمن الوصول إلى أول رمز، والمعدل، والتوازي المتوقع.
فعّل تخزين البوادئ المؤقت
تعيد وكلاء البرمجة استخدام تعليمات المستودع ومخططات الأدوات ومطالبات النظام والبوادئ الطويلة بشكل متكرر.
مع vLLM:
--enable-prefix-caching
تطلبت بنية الانتباه الهجينة لـ K3 معالجة خاصة لتخزين البوادئ المؤقت، وقد نفّذ vLLM دعمًا خاصًا للنموذج لذلك.
استخدم محلّلات K3
لأعباء عمل الوكلاء، أدرج:
--tool-call-parser kimi_k3 \
--reasoning-parser kimi_k3
هذا يُبقي استدعاءات الأدوات ومخرجات الاستدلال متوافقة مع صيغة تقديم K3.
حافظ على تخزين سريع
يضع نموذج بهذا الحجم ضغطًا غير اعتيادي على التخزين المحلي أثناء أول تنزيل، وتحميل نقاط التحقق، والتحديثات، والاسترداد.
تُفضَّل تخZen NVMe على الأقراص البطيئة المركبة عبر الشبكة. إذا شاركت عدة أجهزة ملفات النموذج، تصبح طوبولوجيا مخزن النموذج المؤقت وعرض النطاق للشبكة جزءًا من بنية الاستدلال بدل أن تكون تفاصيل نشر فحسب.
راقب أكثر من استخدام GPU
تتبّع:
- استخدام HBM/VRAM
- RAM على CPU
- معدل ضرب الذاكرة المؤقتة
- زمن الوصول إلى أول رمز
- معدل فك الترميز (رموز/ثانية)
- عمق صف الطلبات
- الاتصال بين وحدات GPU
- عرض النطاق بين العقد
- فشل تحليل استدعاء الأدوات
- زمن تحميل النموذج
على مقياس K3، لا يخبرك رقم استخدام GPU الظاهري الصحي ما إذا كانت طوبولوجيا الخدمة فعالة.
Kimi K3 محليًا مقابل Kimi K3 مستضافًا
تمنح الاستضافة الذاتية الفرق أقصى تحكم في مسار البيانات ووقت التشغيل وأوزان النموذج، بينما تجعلهم مسؤولين أيضًا عن سعة GPU، والتوسعة، والترقيات، والمراقبة، والاسترداد. الوصول المستضاف يُزيل معظم عمل البنية التحتية ويكون عمومًا المسار الأسرع للتقييم أو الطلب المتغير.
للحصول على التحليل الكامل للعتاد ونقطة التعادل، اقرأ Kimi K3 Self-Hosting vs API. لأسعار الرموز والتخزين المؤقت ومقارنات K2.7، استخدم دليل تسعير Kimi K3. لذلك يُبقي هذا المقال المقارنة موجزة ويركز على أوامر النشر والتكوين واستكشاف الأخطاء.
مشكلات شائعة في النشر المحلي لـ Kimi K3
النموذج لا يتسع في ذاكرة GPU
هذا هو الفشل الأكثر توقعًا.
لا تحسب الذاكرة بناءً على 104B من المعاملات المُفعّلة. يصف هذا الرقم الحساب لكل رمز، وليس مقدار بيانات وزن الخبراء الذي يجب أن توفره منظومة الخدمة.
استخدم طوبولوجيا موزعة مدعومة، أو تكميم GGUF أصغر، أو خدمة مستضافة.
أخطاء CUDA أو تعريف NVIDIA
تعتمد صورة vLLM K3 الحالية على CUDA 13 وتتطلب تعريف مضيف R580+.
إذا كان المضيف ما يزال على مكدس R575/CUDA 12.9، فقم بتحديثه أو اتبع مسار البناء من المصدر الذي وصفه vLLM بدل افتراض أن الحاوية ستُصلح عدم توافق تعريف المضيف.
الطلب الأول بطيء للغاية
تحقق مما إذا كانت نقطة التحقق ما تزال تُحمّل، أو تُجمّع الأنوية، أو تُسخّن الذاكرات المؤقتة، أو تسحب الملفات.
مع أصول من فئة التيرابايت المتعددة، “تم بدء عملية الخادم” و“النموذج جاهز لحركة إنتاجية” ليستا حالتين متكافئتين.
فشل استدعاءات الأدوات بشكل متقطع
تشير وصفة vLLM الحالية إلى أن K3 قد يُنتج أحيانًا صيغة لاستدعاء أداة لا يتوقعها محلله. لذا يجب على أنظمة الإنتاج التحقق من صحة مخططات استدعاء الأدوات وتنفيذ إعادة المحاولة بدل الثقة العمياء بكل استدعاء مُولّد.
تصبح المحادثات الطويلة أقل استقرارًا
تأكد من أنك تُعيد الرسالة الكاملة للمساعد—بما في ذلك معلومات الاستدلال والأدوات—إلى أدوار K3 التالية.
قد يُعطل إسقاط الحقول المخفية لحالة الاستدلال نمط سجل التفكير المحفوظ الذي تم تدريب K3 عليه.
إذًا، ما أفضل طريقة لنشر Kimi K3 محليًا؟
بالنسبة لمعظم المؤسسات التي تمتلك العتاد المناسب، vLLM هو أفضل مسار نشر أول. لديه دعم مخصص لـ K3، وواجهة API متوافقة مع OpenAI، ومحللات خاصة بالنموذج، وتخزين مسبق للبوادئ، ودعم فك تكهّنّي، ووصفات عتاد حديثة.
اختر SGLang عندما تكون هندسة الاستدلال الموزع والتحكم الدقيق في الخدمة أكثر أهمية من أقصر مسار إعداد.
اختر llama.cpp مع تكميم GGUF مجتمعي فقط عندما يكون هدفك هو تجارب محطة عمل/خادم وتفهم أن حتى نسخ 1-بت تبقى بمئات الجيجابايت.
لجهاز مطور تقليدي، الاستنتاج الأكثر عملية مختلف: لا تشترِ مئات الجيجابايت من RAM فقط لإجبار K3 على سطح مكتب. اختبر Kimi K3 عبر CometAPI أولًا، وكمّن فوائده على مهامك الخاصة، وانتقل إلى الاستضافة الذاتية فقط عندما تجعل الخصوصية أو الاستفادة المستدامة أو التحكم بالبنية التحتية الاقتصاديات مجدية.
الأسئلة الشائعة
هل يمكن تشغيل Kimi K3 على وحدة GPU استهلاكية واحدة؟
ليس واقعيًا. النموذج أبعد بكثير من سعة VRAM لوحدات GPU الاستهلاكية. تقلّل تكميمات GGUF ذات البِتّات المنخفضة المجتمعية البصمة بشكل كبير، لكن أصغر المتغيرات الحالية ما تزال بمئات الجيجابايت.
هل يمكنني تشغيل Kimi K3 على Mac؟
تنفيذ تجريبي على CPU/Apple Silicon مع GGUF والتفريغ إلى التخزين ممكن من حيث المبدأ، لكن الأداء التفاعلي وسعة الذاكرة هما عاملا القيد. لا ينبغي التعامل مع MacBook نموذجي كمنصة تقديم عملية لـ K3.
هل يدعم Kimi K3 برنامج Ollama؟
يمكن تشغيل إصدارات GGUF المجتمعية عبر Ollama. يُبسط وقت التشغيل الإعداد لكنه لا يغيّر متطلبات الذاكرة الأساسية.
أيهما أفضل لـ Kimi K3: vLLM أم SGLang؟
vLLM أسهل افتراضيًا لنشر إنتاجي جديد. SGLang جذّاب للفرق التي تبني طوبولوجيات خدمة موزعة متطورة. كلاهما من محركات الاستدلال الموصى بها لـ K3 من Moonshot.
كم يبلغ سياق Kimi K3؟
يدعم التحديد الرسمي للنموذج 1,048,576 رمزًا. خادم محلي لا يجب أن يكشف كامل نافذة السياق؛ قد يكون تعيين max-model-len أدنى أكثر عملية للنشر المبكر والتوازي الأعلى.
هل Kimi K3 مفتوح المصدر؟
الوصف الأدق هو “بوزن مفتوح”. أصدرت Moonshot أوزان النموذج بموجب ترخيص Kimi K3. راجع هذا الترخيص مباشرة قبل إعادة التوزيع التجاري أو أي استخدام يهمه شروط الترخيص.
ما أسهل طريقة لاستخدام Kimi K3 دون وحدات GPU محلية؟
واجهة API مستضافة هي أبسط طريق. Kimi K3 متاح عبر CometAPI بواجهة دردشة متوافقة مع OpenAI، لذا يمكن أن يبقى كود التطبيق قريبًا مما ستستخدمه ضد خادم vLLM أو SGLang محلي.
