تخطى إلى المحتوى الرئيسي
PromptQuorumمصمم للبشر. منظم للذكاء الاصطناعي.
الرئيسية/LLM المحلية المتقدمة
Overview & Reference

مراجعة KoboldCpp: ملف واحد، بلا تثبيت، مصمم للعب الأدوار

·٨ دقائق للقراءةبقلم · مؤسس PromptQuorum · محرك اكتشاف للذكاء الاصطناعي مفتوح الأوزان ومفتوح المصدر

KoboldCpp تطبيق نماذج لغوية محلي مجاني بملف واحد مبني فوق llama.cpp، يشغّل نماذج GGUF دون تثبيت ويضم KoboldAI Lite، وهو محرر لكتابة القصص ولعب الأدوار وليس مجرد نافذة محادثة.

النقاط الرئيسية

  • رخصة AGPL 3.0 — استخدام مجاني، مع التزام النسخة المتروكة (copyleft) عند التعديل وإعادة التوزيع كخدمة شبكية
  • مبني في الخلفية على llama.cpp (رخصة MIT)، مع واجهته الخاصة وميزات إضافية فوقه
  • ملف تنفيذي واحد لكل منصة: ويندوز، لينكس x64، ماك أو إس ARM64 — بلا مثبّت
  • KoboldAI Lite، الواجهة المدمجة على الويب، مصممة لكتابة القصص ولعب الأدوار: مخرجات قابلة للتحرير، حقول Memory وWorld Info، وعدة أوضاع محادثة/مغامرة
  • تسريع المعالج الرسومي عبر CUDA (إنفيديا) أو Vulkan (متعدد الموردين، الطريق الموصى به لـ AMD)؛ توجد نسخة ROCm متجددة للينكس؛ العمل بالمعالج المركزي فقط مدعوم بالكامل أيضًا
  • يتضمن أيضًا توليد صور بتقنية Stable Diffusion ونسخًا صوتيًا بتقنية Whisper في الملف التنفيذي نفسه

📍 في جملة واحدة

KoboldCpp تطبيق نماذج لغوية محلي مجاني برخصة AGPL 3.0 بملف واحد، مبني على llama.cpp، يشغّل نماذج GGUF دون تثبيت ويأتي مزودًا بواجهة KoboldAI Lite على الويب لكتابة القصص ولعب الأدوار.

💬 بعبارات بسيطة

حمّل ملفًا واحدًا وانقر عليه نقرًا مزدوجًا، ليفتح تبويب متصفح فيه واجهة محادثة وتحرير قصصي جاهزة مسبقًا — بلا مثبّت منفصل، وبلا إعداد سطر أوامر، وبلا حاجة لتطبيق إضافي فوقه.

📌ملاحظة: يوصي README الخاص بـ KoboldCpp بالوثوق فقط بالملفات التنفيذية الرسمية في صفحة GitHub Releases. أي ملف يحمل الاسم نفسه على موقع آخر لا يمكن التحقق من كونه النسخة الأصلية.

KoboldCpp هو ملف تنفيذي واحد يشغّل نماذج بصيغة GGUF دون الحاجة إلى مثبّت أو بيئة Python أو Docker، ويأتي مزودًا بمحرر مخصص لكتابة القصص ولعب الأدوار بدلاً من مجرد نافذة محادثة بسيطة.

مراجعة KoboldCpp: ملف واحد، بلا تثبيت، مصمم للعب الأدوار

من أين يمكن الحصول على KoboldCpp؟

يُحمَّل KoboldCpp من صفحة Releases الرسمية على GitHub؛ لا يوجد مثبّت ولا صفحة في متجر تطبيقات.

المنصة
مصدر التحميل
Windows (NVIDIA)koboldcpp.exe
Windows (AMD وIntel والمعالج)koboldcpp-nocuda.exe
Windows (جهاز قديم)koboldcpp-oldpc.exe
Linux x64koboldcpp-linux-x64
Linux (AMD ROCm)ملف ROCm المتجدد
macOS (Apple Silicon)koboldcpp-mac-arm64
الشيفرة المصدريةGitHub (AGPL 3.0)
الموقع الرسميkoboldcpp.net

في Windows يكفي النقر المزدوج على ملف .exe؛ أما ملفات Linux وmacOS فيجب جعلها قابلة للتنفيذ (chmod +x) وتشغيلها من الطرفية، وقد يحظر macOS التشغيل الأول. يحيل الموقع الرسمي إلى صفحة Releases نفسها على GitHub للتحميل. لم يُعثر على صفحة سياسة خصوصية في koboldcpp.net بتاريخ 2 نوفمبر 2026.

ما متطلبات تشغيل KoboldCpp؟

لا ينشر KoboldCpp حدًا أدنى ثابتًا للمواصفات: ما تحتاجه يعتمد على نموذج GGUF الذي تحمّله وطول السياق. وحدة GPU مخصصة اختيارية. فيما يلي خيارات الإصدار والمعاملات المهمة.

  • Windows: استخدم koboldcpp.exe لبطاقات NVIDIA (CUDA)، أو koboldcpp-nocuda.exe (تنزيل أصغر ويدعم المعالج وVulkan)، أو koboldcpp-oldpc.exe إذا لم يعمل الإصدار الرئيسي على جهاز أقدم.
  • Linux x64: نزّل koboldcpp-linux-x64، واجعله قابلًا للتنفيذ بالأمر chmod +x koboldcpp-linux-x64، ثم شغّله من الطرفية. توجد أيضًا نسخ -nocuda و-oldpc.
  • macOS: استخدم koboldcpp-mac-arm64 مع Apple Silicon (سلسلة M). أجهزة Mac بمعالج Intel تتطلب بناءً من الشيفرة المصدرية.
  • معاملات GPU: --usecuda (NVIDIA فقط) أو --usevulkan (AMD وNVIDIA وIntel). يحدد --gpulayers N عدد الطبقات المحمّلة على GPU (الافتراضي -1 = ضبط تلقائي، 0 = بدون نقل إلى GPU)، ويحدد --contextsize N أقصى طول للسياق.
  • قاعدة تقريبية للذاكرة: يجب أن تتسع أوزان النموذج مع السياق في VRAM (أو في RAM عند التشغيل بالمعالج فقط). يحوّل الجدول في القسم التالي ذلك إلى أحجام نماذج لكل مستوى من VRAM.

ما هو KoboldCpp؟

KoboldCpp برنامج مجاني بملف واحد يشغّل نماذج لغوية بصيغة GGUF محليًا، مبني على محرك استدلال llama.cpp ويصونه مطور مجهول الهوية يُعرف باسم LostRuins. يرث اصطلاحات واجهة مشروع KoboldAI الأصلي، مع تكييفها للعمل فوق خلفية llama.cpp بدلاً من مكدس استدلال قائم على Python.

يستضاف المشروع على github.com/LostRuins/koboldcpp ويُنشر بموجب رخصة GNU Affero العمومية العامة الإصدار 3 (AGPL 3.0) — وهي رخصة نسخة متروكة، تختلف عن رخصة MIT المتساهلة التي يستخدمها llama.cpp نفسه في الخلفية. تصدر الإصدارات بشكل متكرر.

أحدث إصدار هو v1.124.2 الصادر في 31 أكتوبر 2026؛ وكان آخر تحديث للمستودع في 13 نوفمبر 2026. تضيف سلسلة v1.124 مجموعة من نماذج تحويل النص إلى كلام وتوليد الموسيقى YuE2 المدمجة من audio.cpp. وتجد الإصدارات السابقة، ومنها v1.123.1 (13 أكتوبر 2026)، في صفحة Releases. يُكتب الاسم أحيانًا Kobold CPP أو kobold.cpp أو koboldccp، وكلها تشير إلى المشروع نفسه.

  • يُوزَّع كملف تنفيذي واحد لكل منصة — koboldcpp.exe (ويندوز)، koboldcpp-linux-x64 (لينكس)، koboldcpp-mac-arm64 (ماك أو إس Apple Silicon)
  • لا يتطلب تشغيله مثبّتًا ولا بيئة Python ولا Docker
  • يعتمد على llama.cpp لاستدلال النموذج الفعلي، ثم يضيف فوقه خادمه الخاص وواجهته على الويب وطبقة واجهة برمجة التطبيقات
  • يوفر نسخة nocuda (بلا CUDA، متوافقة مع Vulkan) ونسخة oldpc (CUDA11 + AVX1) للعتاد القديم، إلى جانب النسخة الرئيسية المزودة بـ CUDA

ما هو KoboldAI Lite، وماذا يضيف؟

KoboldAI Lite هي واجهة الويب المدمجة مباشرة داخل الملف التنفيذي لـ KoboldCpp — تفتح تلقائيًا في تبويب متصفح بمجرد بدء تشغيل الخادم، دون خطوة تثبيت منفصلة. وهي مصممة خصيصًا للكتابة الطويلة ولعب الأدوار، وليس فقط للمحادثة بالتناوب.

  • مخرجات قابلة للتحرير: يمكن تعديل النص المولَّد مباشرة وليس فقط إعادة توليده — أمر مهم للكتابة القصصية التعاونية
  • حقلا Memory وWorld Info: كتل سياق دائمة يراها النموذج دومًا، تُستخدم للحفاظ على تفاصيل الشخصيات أو حقائق القصة متسقة عبر جلسة طويلة
  • أوضاع متعددة: محادثة عادية، ووضع "Story" للتأليف التعاوني، ووضع "Adventure" على طراز ألعاب المغامرات النصية
  • أدوات تحكم Author's Note وتنسيق instruct لتوجيه النبرة والأسلوب دون تعديل قالب الطلب الأساسي يدويًا
  • يعمل بالكامل من الملف التنفيذي نفسه والخادم المحلي نفسه — دون الحاجة لتطبيق واجهة أمامية أو إضافة متصفح منفصلة

كيف تُحمّل وتشغّل KoboldCpp؟

حمّل الملف المناسب لمنصتك من صفحة GitHub Releases الرسمية، ثم شغّله مباشرة — لا توجد خطوة تثبيت. اختيار النسخة المناسبة لعتادك هو القرار الحقيقي الوحيد المطلوب.

  1. 1
    انتقل إلى صفحة إصدارات KoboldCpp على GitHub — وهي مصدر التحميل الذي يحدده المشروع بوصفه رسميًا.
  2. 2
    اختر نسخة منصتك: koboldcpp.exe لويندوز، koboldcpp-linux-x64 للينكس، أو koboldcpp-mac-arm64 لماك أو إس على Apple Silicon.
  3. 3
    اختر مسار المعالج الرسومي المناسب: تتضمن النسخة الرئيسية دعم CUDA من إنفيديا؛ ولمستخدمي AMD يوصي المشروع بتجربة خيار Vulkan في نسخة nocuda أولاً؛ وتوجد نسخة ROCm متجددة منفصلة للينكس؛ أما العتاد القديم الذي يفتقر لمجموعات التعليمات الحديثة فيجب أن يستخدم نسخة oldpc (CUDA11 + AVX1).
  4. 4
    حمّل ملف نموذج بصيغة GGUF (مثلًا من Hugging Face) إن لم يكن لديك واحد بالفعل.
  5. 5
    شغّل الملف التنفيذي، واختر ملف GGUF وكمية تفريغ الطبقات على المعالج الرسومي في نافذة التشغيل، ثم ابدأ الخادم.
  6. 6
    يفتح تبويب متصفح تلقائيًا على واجهة KoboldAI Lite، متصلة بالفعل بالخادم المحلي قيد التشغيل.

هل يتطلب KoboldCpp تثبيتًا؟

لا. إنه ملف تنفيذي واحد — حمّله وشغّله مباشرة. لا يوجد مثبّت، ولا بيئة Python منفصلة، ولا حاوية Docker.

هل يمكن تشغيل KoboldCpp دون معالج رسومي؟

نعم. العمل بالمعالج المركزي فقط مدعوم بالكامل؛ ووجود معالج رسومي (عبر CUDA أو Vulkan أو ROCm) يسرّع سرعة التوليد فقط، وليس شرطًا أبدًا.

ما المعالجات الرسومية والعتاد الذي يدعمه KoboldCpp؟

يدعم KoboldCpp إعدادات إنفيديا وAMD والمعالج المركزي فقط عبر نسخ بناء منفصلة، بدلًا من ملف تنفيذي واحد شامل يكتشف كل شيء تلقائيًا. اختيار النسخة المطابقة لعتادك ضروري لتفعيل تسريع المعالج الرسومي.

  • إنفيديا — تسريع CUDA مدمج في ملفات الإصدار الرئيسية
  • AMD — يوصي المشروع نفسه بتجربة خلفية Vulkan في نسخة nocuda أولاً لأنها الأوسع توافقًا؛ كما يُصان ملف ROCm متجدد منفصل للينكس
  • متعدد الموردين — تعمل خلفية Vulkan أيضًا على رسوميات إنتل وبطاقات إنفيديا/AMD الأقدم دون تعريفات خاصة بالموردين
  • العتاد القديم — نسخة oldpc موجهة لـ CUDA 11 والمعالجات المركزية التي تدعم AVX1 فقط، للأجهزة غير القادرة على تشغيل النسخة الحديثة القياسية
  • المعالج المركزي فقط — تعمل نسخة nocuda دون أي معالج رسومي، بسرعة أقل مقارنة بالاستدلال المسرَّع بالمعالج الرسومي

ما النماذج التي تتسع في VRAM مع KoboldCpp؟

مع تكميم Q4، تناسب 8 GB من VRAM نماذج 7-8B، و12 GB نماذج 13-14B، و16 GB فئة 22B، و24 GB نماذج 22-32B؛ أما نموذج 70B فيحتاج نحو 48 GB. وبفضل --gpulayers يمكن لـ KoboldCpp نقل جزء فقط من النموذج إلى GPU، فتعمل النماذج الأكبر أيضًا ولكن ببطء أكبر.

VRAM
نموذج Q4 المناسب
ملاحظة
4 GBفئة 3B (نحو 2 GB بـ Q4)نماذج صغيرة أو نقل جزء إلى RAM
8 GB7-8B (نحو 4 GB بـ Q4)المستوى الشائع مع هامش
12 GB13-14B (نحو 8 GB بـ Q4)مساحة لسياق أطول
16 GBفئة 22B (نحو 13 GB بـ Q4)السقف العملي لهذا المستوى
24 GB22-32B (من Q4 إلى Q8)70B لا يتسع دون فقدان الجودة
48 GB70B (نحو 42 GB بـ Q4)أول مستوى يتسع لـ 70B بـ Q4

تقديرات من دليل VRAM في PromptQuorum: أحجام أوزان Q4 مع 1-2 GB للسياق، وليست قياسات من KoboldCpp. لاختيار GPU لكل مستوى راجع دليل عتاد LLM المحلية.

لمن يناسب KoboldCpp؟

استخدم KoboldCpp إذا كانت كتابة القصص أو لعب الأدوار أو ملف واحد بلا تثبيت أهم من الإنتاجية الخام أو الحجم الأدنى؛ واستخدم أداة أخرى إذا احتجت خدمة إنتاجية متعددة المستخدمين أو أصغر تحميل ممكن.

🧭 لمن يناسب KoboldCpp

  • مستخدمو لعب الأدوار والتأليف التعاوني الراغبون في محرر بحقول Memory/World Info مدمجة، لا مجرد فقاعة محادثة
  • أي شخص يريد تجربة نموذج محلي بأقل إعداد ممكن — ملف واحد، تحميل واحد، بلا سلسلة أدوات بناء
  • مستخدمو العتاد القديم أو AMD، حيث توفر نسخ Vulkan أو oldpc مسارًا أكثر موثوقية من الأدوات السائدة المعتمدة على CUDA أولًا
  • من يريدون أيضًا توليد صور أساسي أو نسخًا صوتيًا في التطبيق نفسه، دون تثبيت أداة منفصلة لكل ميزة

❌ لمن لا يناسبه KoboldCpp

  • الفرق التي تحتاج خدمة إنتاجية متعددة المستخدمين وعالية التزامن — vLLM أو NVIDIA TensorRT-LLM مصممتان لذلك، وليس KoboldCpp
  • المؤسسات التي لديها سياسة ضد البرمجيات ذات رخصة AGPL (النسخة المتروكة) — يُنصح بمراجعة الشؤون القانونية قبل دمج KoboldCpp في منتج تجاري سيُعدَّل ويُعاد توزيعه
  • من يريد أصغر تحميل ممكن — الملف التنفيذي الواحد يضم الواجهة وتوليد الصور والنسخ الصوتي سواء استُخدمت أم لا
  • من يبحث عن عميل محادثة بسيط بلا عناصر واجهة خاصة بلعب الأدوار — يناسب Ollama مع واجهة أمامية خفيفة منفصلة بشكل أفضل

🏆 أفضل اختيار حسب حالة الاستخدام

  • مناسب للعب الأدوار وكتابة القصص مع محرر مدمج: KoboldCpp
  • مناسب لإعداد محلي بسيط مع واجهة أوامر لإدارة النماذج: Ollama
  • مناسب لواجهة سطح مكتب بلا طرفية: LM Studio
  • مصمم لخدمة متعددة المستخدمين وعالية الإنتاجية: vLLM أو TensorRT-LLM
  • مناسب للتحكم المباشر في خلفيات العتاد: llama.cpp مباشرة

كيف يقارَن KoboldCpp بـ Ollama وأدوات محلية أخرى؟

أقرب مقارنات KoboldCpp هي أدوات أخرى مبنية على llama.cpp، إضافة إلى محركات إنتاجية موجهة لمهمة مختلفة تمامًا.

الأداة
الرخصة
الأفضل لـ
KoboldCppAGPL 3.0بلا تثبيت، واجهة لعب أدوار/كتابة مدمجة
llama.cppMITأوسع دعم للعتاد، تحكم مباشر
OllamaMITواجهة أوامر/API بسيطة، إدارة النماذج
LM Studioملكية خاصة (مجاني)واجهة سطح مكتب بلا طرفية
vLLMApache 2.0خدمة متعددة المستخدمين وعالية الإنتاجية
text-generation-webuiAGPL 3.0تخصيص عميق للواجهة، خلفيات كثيرة

قارن في الدليل

أخطاء شائعة عند تقييم KoboldCpp

ينشأ معظم اللبس من التعامل مع KoboldCpp كتطبيق مثبَّت تقليدي، أو من تحميله من مصدر غير رسمي.

الخطأ الأول: تحميل KoboldCpp من موقع غير GitHub Releases

يحدد README الخاص بـ KoboldCpp صفحة GitHub Releases مصدرًا للتحميلات الرسمية. لا يمكن التحقق من أن ملفًا يحمل الاسم نفسه على موقع طرف ثالث هو النسخة الأصلية.

الخطأ الثاني: استخدام نسخة CUDA على معالج رسومي AMD

تسريع CUDA في النسخة الرئيسية يعمل فقط مع معالجات إنفيديا الرسومية. يحتاج مستخدمو AMD خيار Vulkan داخل نسخة nocuda، أو نسخة ROCm المتجددة المنفصلة للينكس — استخدام النسخة الخاطئة يعيد التشغيل ببساطة إلى استدلال أبطأ بالمعالج المركزي فقط.

الخطأ الثالث: افتراض أن AGPL 3.0 تعمل مثل رخصة MIT الخاصة بـ llama.cpp

llama.cpp (المحرك الذي يُبنى عليه KoboldCpp) مرخّص بموجب MIT؛ أما KoboldCpp نفسه فمرخّص بموجب AGPL 3.0، وهي رخصة نسخة متروكة. الاستخدام الشخصي والداخلي لا يستوجب أي نشر، لكن تعديل KoboldCpp وتقديمه كخدمة شبكية لآخرين يفعّل شرط نشر الشيفرة المصدرية في AGPL — اقرأ نص الرخصة قبل بناء منتج تجاري عليه. هذا ملخص عام وليس استشارة قانونية.

الأسئلة الشائعة

ما هو KoboldCpp؟

KoboldCpp تطبيق نماذج لغوية محلي مجاني بملف واحد، مبني على llama.cpp. يشغّل نماذج GGUF دون خطوة تثبيت، ويأتي مزودًا بواجهة KoboldAI Lite على الويب، المصممة لكتابة القصص ولعب الأدوار.

ما الفرق بين KoboldCpp وllama.cpp؟

يعتمد KoboldCpp على llama.cpp ويشغّل نماذج GGUF نفسها. llama.cpp هو محرك الاستدلال برخصة MIT مع أوسع دعم للأجهزة وتحكم مباشر؛ أما KoboldCpp (AGPL 3.0) فيجمعه في ملف تنفيذي واحد مع واجهة KoboldAI Lite لكتابة القصص ولعب الأدوار، إضافةً إلى توليد الصور عبر Stable Diffusion والتعرف على الكلام عبر Whisper.

من يصون KoboldCpp؟

يصون KoboldCpp مطور مجهول الهوية يُعرف باسم LostRuins، على مستودع github.com/LostRuins/koboldcpp. تصدر الإصدارات بتكرار.

هل KoboldCpp مجاني؟

نعم. KoboldCpp مجاني ومفتوح المصدر برخصة AGPL 3.0. لا توجد فئة مدفوعة ولا منتج مستضاف — كل نشر لـ KoboldCpp يعمل على عتاد يتحكم به المستخدم بنفسه.

ما الرخصة التي يُنشر بموجبها KoboldCpp؟

AGPL 3.0 (رخصة GNU Affero العمومية العامة الإصدار 3)، وهي رخصة نسخة متروكة. تختلف عن رخصة MIT التي يستخدمها llama.cpp، المحرك الذي يُبنى عليه KoboldCpp في الخلفية. هذا ملخص عام وليس استشارة قانونية؛ اقرأ نص الرخصة بما يناسب حالة استخدامك.

هل يتطلب KoboldCpp تثبيتًا؟

لا. يُوزَّع كملف تنفيذي واحد لكل منصة (ويندوز، لينكس، ماك أو إس ARM64) — حمّله وشغّله مباشرة، دون مثبّت أو بيئة Python أو حاوية Docker.

هل يدعم KoboldCpp معالجات AMD الرسومية؟

نعم، لكن ليس عبر نسخة CUDA الرئيسية. يوصي المشروع بخيار Vulkan داخل نسخة nocuda كمسار أول لـ AMD، إلى جانب نسخة ROCm متجددة تُصان بشكل منفصل للينكس.

ما هو KoboldAI Lite؟

KoboldAI Lite هي الواجهة على الويب المضمَّنة في الملف التنفيذي لـ KoboldCpp. تفتح تلقائيًا في المتصفح بمجرد بدء تشغيل الخادم، وتوفر مخرجات قابلة للتحرير، وحقلي Memory وWorld Info، وأوضاعًا مخصصة للمحادثة والقصة والمغامرة للعب الأدوار والكتابة التعاونية.

هل يستطيع KoboldCpp توليد صور أو نسخ الصوت؟

نعم. يضم الملف التنفيذي نفسه توليد صور بتقنية Stable Diffusion ونسخًا صوتيًا بتقنية Whisper، إلى جانب وظيفته الأساسية في توليد النصوص.

هل يصلح KoboldCpp للإنتاج أو الاستخدام متعدد المستخدمين؟

لا، فهذا ليس هدف تصميمه. صُمم KoboldCpp للاستخدام المحلي بمستخدم واحد مع واجهة كتابة غنية؛ أما لخدمة إنتاجية متعددة المستخدمين وعالية التزامن، فإن vLLM أو NVIDIA TensorRT-LLM هما الأداتان المناسبتان.

ما الفرق بين KoboldCpp وOllama؟

كلاهما يعتمد على llama.cpp، لكن Ollama يراهن على واجهة أوامر بسيطة وسجل نماذج بلا واجهة مدمجة، بينما يضم KoboldCpp واجهة كاملة للكتابة ولعب الأدوار داخل المتصفح (KoboldAI Lite) ضمن الملف التنفيذي الواحد نفسه.

هل تحميل KoboldCpp آمن؟

الشيفرة المصدرية لـ KoboldCpp متاحة علنًا بموجب AGPL 3.0، ويحدد المشروع صفحة Releases على GitHub مصدرًا رسميًا للتحميل، كما يحذّر موقعه من المواقع المزيفة. لم تُدقق PromptQuorum الشيفرة ولم تفحص الملفات التنفيذية، لذا حمّل من المصادر الرسمية للمشروع فقط (GitHub Releases أو الروابط الواردة في ملاحظات الإصدار) وعامل أي مصدر آخر على أنه غير موثّق.

المصادر

← العودة إلى LLM المحلية المتقدمة

MCP