LocalAI

LocalAI هو محرك استدلال للذكاء الاصطناعي مجاني وذاتي الاستضافة، صممه Ettore Di Giacinto (حسابه على GitHub: mudler)، ليوفر لك بديلاً جاهزاً لواجهة برمجة تطبيقات OpenAI يعمل بالكامل على أجهزتك الخاصة. تم إصداره في عام 2023 بموجب ترخيص MIT، وحصد ما يقرب من 46,000 نجمة على GitHub بحلول أبريل 2026. الوعد الأساسي بسيط للغاية: قم بتوجيه أي تطبيق أو حزمة تطوير برمجيات (SDK) تدعم تنسيق واجهة برمجة تطبيقات OpenAI إلى مثيل LocalAI الخاص بك بدلاً من ذلك، وستعمل نماذجك محلياً دون أن تغادر أي بيانات شبكتك. لا توجد اشتراكات، ولا يُشترط وجود وحدة معالجة رسومات (GPU)، ولا يوجد حد أقصى للاستخدام.

يدعم LocalAI أكثر من 36 واجهة خلفية للاستدلال، بما في ذلك llama.cpp و whisper.cpp و vLLM و Transformers و diffusers و Bark و ExLlama2. تغطية تنسيقات النماذج هي الأوسع في فئة الاستضافة الذاتية: حيث تعمل تنسيقات GGUF و GGML و Safetensors و PyTorch و GPTQ و AWQ بشكل أصلي. وبعيداً عن النصوص، يمكن لمثيل LocalAI واحد أن يخدم النماذج اللغوية الكبيرة (LLMs)، وتوليد الصور عبر Stable Diffusion، وتحويل الكلام إلى نص عبر Whisper، وتوليد الصوت (TTS)، وتضمينات CLIP، وتوليد الفيديو، كل ذلك من نقطة نهاية API موحدة. أضاف إصدار v4.0.0 في مارس 2025 تنسيقاً أصلياً للوكلاء (agentic orchestration)، ودعماً لبروتوكول MCP، وواجهة مستخدم React مُعاد كتابتها مع وضع Canvas، وصوتاً في الوقت الفعلي عبر WebRTC، مما حوّل LocalAI من خادم استدلال إلى منصة ذكاء اصطناعي متكاملة ذاتية الاستضافة.

ما الذي يقدمه LocalAI فعلياً في أبريل 2026

في جوهره، LocalAI هو خادم HTTP مكتوب بلغة Go يقوم بترجمة طلبات API المتوافقة مع OpenAI إلى استدعاءات استدلال موجهة للواجهة الخلفية التي يحتاجها أي نموذج معين. يمكنك تثبيته عبر Docker أو كملف تنفيذي (binary) أو عبر Kubernetes، وتحميل نموذج من المعرض بنقرة واحدة، وسيعمل كود OpenAI SDK الحالي الخاص بك دون أي تعديل، فقط باستخدام عنوان URL أساسي مختلف.

يغطي معرض النماذج مئات النماذج المعدة مسبقاً: Llama 3 و Mixtral و Phi و Gemma و Qwen و Mistral و DeepSeek، وغيرها الكثير، كل منها مزود بملف تكوين YAML جاهز يحدد الواجهة الخلفية الصحيحة، وقالب التلقين (prompt template)، ونافذة السياق، والتكميم (quantization). أما بالنسبة للنماذج غير الموجودة في المعرض، فيمكنك كتابة ملف تكوين YAML بنفسك، وهو أمر مرن ولكنه يضيف بعض التعقيد في الإعداد مقارنة بأدوات مثل Ollama.

اعتباراً من الإصدار v4.1.3 (6 أبريل 2026)، تتضمن مجموعة الميزات: توليد النصوص مع استدعاء الدوال واستخدام الأدوات، وتوليد الصور عبر Stable Diffusion و FLUX، وتحويل الكلام إلى نص عبر Whisper و Moonshine، وتوليد الصوت (TTS) عبر Bark و Piper و Kokoro و Pocket-TTS، والتضمينات وإعادة الترتيب لمسارات RAG، والتعرف على الوجوه عبر InsightFace، وتوليد الفيديو عبر LTX-2، والتجميع الموزع (distributed clustering) عبر عُقد متعددة، ومصادقة OIDC لعدة مستخدمين مع حصص مخصصة لكل مستخدم، وتتبع الطلبات، وإطار عمل مدمج للوكلاء (LocalAGI) مع تكامل خادم MCP.

يشمل دعم الأجهزة NVIDIA CUDA و AMD ROCm و Apple Silicon Metal و Intel Arc و Vulkan لوحدات معالجة الرسومات المدمجة، بالإضافة إلى خيار وحدة المعالجة المركزية (CPU) فقط لأي جهاز لا يحتوي على بطاقة رسومات مخصصة. يمكن لجهاز Raspberry Pi تشغيل النماذج الصغيرة. بينما يمكن لخادم متعدد وحدات معالجة الرسومات (multi-GPU) تشغيل النماذج الكبيرة الموزعة.

موقع LocalAI مقارنة بـ Ollama و vLLM

تهيمن ثلاث أدوات على فئة بيئات تشغيل النماذج اللغوية الكبيرة (LLM) ذاتية الاستضافة: LocalAI و Ollama و vLLM. هذه الأدوات ليست قابلة للتبديل فيما بينها، والاختيار الخاطئ قد يسبب متاعب حقيقية.

LocalAI مقابل Ollama: يستخدم Ollama واجهة llama.cpp كواجهة خلفية وحيدة للاستدلال وتنسيق GGUF كتنسيق أساسي للنماذج. يستغرق الإعداد أقل من 60 ثانية باستخدام أمر CLI واحد. لا يدعم Ollama بشكل أصلي توليد الصور أو TTS أو STT أو أعباء عمل الانتشار (diffusion): فهو خادم LLM أحادي النمط مُحسّن للبساطة. كما يفتقر إلى استدعاءات الأدوات المتدفقة (streaming tool calls) ومعلمة tool_choice اعتباراً من أبريل 2026. يدعم LocalAI جميع هذه السيناريوهات، بالإضافة إلى ستة تنسيقات للنماذج مقابل تنسيق واحد في Ollama، ولكنه يتطلب تكويناً أكثر بكثير للوصول إلى حالة التشغيل. حكم المجتمع (من مساحات homelab و r/selfhosted) صريح: "كان LocalAI رائعاً من حيث التوافق. لكن Ollama أفضل في كل شيء آخر." هذا دقيق إذا كنت تحتاج فقط إلى نماذج نصية. أما إذا كنت بحاجة إلى Whisper + Stable Diffusion + نموذج LLM من نقطة نهاية واحدة، فإن LocalAI هو الخيار الوحيد مفتوح المصدر الذي يقوم بالثلاثة معاً بشكل أصلي.

LocalAI مقابل vLLM: يُعد vLLM خادم استدلال مخصص لبيئات الإنتاج يستخدم PagedAttention، وهو نظام إدارة ذاكرة افتراضية لذاكرة التخزين المؤقت GPU KV يقضي على تجزئة الذاكرة. في ظل وجود أكثر من 50 مستخدماً متزامناً، يحقق vLLM حوالي 793 رمزاً (token) في الثانية مقابل 41 رمزاً في الثانية لـ Ollama؛ ويبلغ زمن الوصول P99 في ذروته 80ms (لـ vLLM) مقابل 673ms (لـ Ollama). لا يتم قياس أداء LocalAI في هذا المستوى ولم يُصمم لحالة الاستخدام هذه. يتطلب vLLM وحدة معالجة رسومات NVIDIA أو ROCm مخصصة، وبرامج تشغيل CUDA/ROCm، وبيئة Python، وصبراً في حل التبعيات. كما أنه لا يدعم نماذج GGUF على الإطلاق، ولا يمتلك أي قدرة على توليد الصور أو الصوت أو الفيديو. يعمل LocalAI باستخدام وحدة المعالجة المركزية (CPU) فقط على لوحة بسعر 50 دولاراً؛ بينما يحتاج vLLM إلى بطاقة A100 ليتألق. كل منهما يخدم أهدافاً مختلفة.

"يُوصى باستخدام LocalAI عندما تحتاج إلى وكلاء رؤية أو صوت، لتشغيل Whisper و CLIP و Stable Diffusion محلياً باستخدام ملف YAML واحد." - glukhov.org، الدليل الشامل لاستضافة LLM المحلية 2025، نوفمبر 2025

كيف يبدو واقع واجهة برمجة التطبيقات (API) ذاتية الاستضافة

يبدأ سير العمل النموذجي في LocalAI باستخدام Docker. قم بسحب الصورة (image)، وتشغيلها مع ربط وحدة تخزين (volume mount) لدليل النماذج الخاص بك، وستظهر واجهة مستخدم الويب على المنفذ 8080. من هناك، يتيح لك معرض النماذج تثبيت نماذج منتقاة بنقرة واحدة: يتم إسقاط ملف YAML مُعد مسبقاً في مجلد النماذج الخاص بك ويبدأ التنزيل في الخلفية. بالنسبة لنماذج المعرض، فإن هذه العملية سلسة تقريباً مثل Ollama.

خارج المعرض، يمكنك تكوين النماذج عن طريق إسقاط ملفات YAML في دليل النماذج. يحدد تكوين LLM النموذجي: اسم ملف النموذج، والواجهة الخلفية (مثل llama-cpp)، وقالب التلقين (ChatML و Alpaca و Vicuna وما إلى ذلك)، وحجم نافذة السياق، وطبقات GPU المراد تفريغها، ودرجة الحرارة الافتراضية. يتطلب هذا جهداً أكبر من نهج Ollama الخالي من التكوين، ولكنه يمنحك تحكماً دقيقاً في كل معلمة استدلال. تتطلب نماذج توليد الصور تكوينات YAML مشابهة تشير إلى مسار diffusers أو ملف SD .ckpt.

أضافت واجهة مستخدم React في الإصدار v4.0 وضع Canvas لعرض التعليمات البرمجية، و Agenthub لاستيراد الوكلاء المشتركين من المجتمع، وإدارة تطبيقات MCP حتى تتمكن من ربط خوادم الأدوات مباشرة بواجهة الدردشة. بالنسبة للمستخدمين الذين قاموا بتشغيل LocalAI سابقاً عبر API فقط بدون واجهة مستخدم، تُعد واجهة v4.x ترقية جوهرية. أما بالنسبة لسير العمل المعتمد على واجهة سطر الأوامر (CLI) أولاً، فإن واجهة برمجة التطبيقات المتوافقة مع OpenAI تظل دون تغيير.

"أستخدمه يومياً. سريع وموثوق ولا يتجسس عليك." - مراجعة مستخدم مجهول، noizz.io، 22 يناير 2026

الإحباطات حقيقية وموثقة في مشكلات GitHub. يعاني Docker على نظام Windows من مشاكل مستمرة: عدم الاستفادة الكاملة من وحدة المعالجة المركزية، وتوقف بدء التشغيل المرتبط بعدم تطابق مسارات محرك Docker مع WSL، والحاويات التي تستغرق دقائق للبدء بينما يبدأ Ollama في ثوانٍ. يمكن أن يفشل تثبيت الواجهة الخلفية بصمت دون خطأ واضح، مما يترك المستخدمين مع خادم API يعمل ولكن بدون قدرة على الاستدلال. أدت تحديثات Docker إلى مسح التكوينات المحفوظة في مشكلة واحدة موثقة جيداً على الأقل (#6924). كما أدت عمليات استيراد نماذج MLX من Hugging Face إلى تعطل المثيلات مما تطلب إعادة التشغيل. هذه مشاكل قابلة للحل، لكنها تمثل نقاط احتكاك حقيقية للمستخدمين الذين يتوقعون سلاسة Ollama.

لمن صُمم LocalAI

يُعد LocalAI الخيار الصحيح لثلاث حالات محددة. أولاً، المطورون الذين يدمجون الذكاء الاصطناعي المحلي في التطبيقات أو الأدوات الداخلية والذين يستخدمون بالفعل واجهة برمجة تطبيقات OpenAI ويرغبون في عدم إجراء أي تغييرات على التعليمات البرمجية عند التبديل إلى الاستدلال المحلي. التوافق الجاهز يعني أن توجيه عنوان URL الأساسي لـ SDK إلى مكان آخر هو كل ما يتطلبه الانتقال. ثانياً، مشغلو البنية التحتية ذاتية الاستضافة و homelab الذين يريدون خدمة واحدة تتعامل مع أعباء عمل LLM والصور والصوت والتضمين دون تشغيل خدمات Ollama و ComfyUI و Whisper منفصلة. ثالثاً، الفرق التي تضع الخصوصية في المقام الأول في الصناعات الخاضعة للتنظيم (الرعاية الصحية، القانونية، المالية) حيث تعتبر سيادة البيانات متطلباً صارماً. إضافة مصادقة OIDC وحصص المستخدمين في الإصدار v4.1 تجعل النشر المناسب لعدة مستخدمين أمراً ممكناً دون الحاجة إلى إعداد وكيل عكسي (reverse proxy) معقد.

يُعد LocalAI أيضاً خياراً قوياً للمستخدمين الذين يمتلكون أجهزة مختلطة أو قديمة. خيار وحدة المعالجة المركزية (CPU) فقط ليس مجرد ملاحظة تسويقية: فالنماذج المكممة GGUF بتنسيق Q4_K_M تعمل بشكل مناسب على الأجهزة التي تحتوي على ذاكرة وصول عشوائي (RAM) بسعة 16 جيجابايت وبدون وحدة معالجة رسومات منفصلة. يستفيد مستخدمو Apple Silicon من تسريع Metal عبر واجهات MLX و llama.cpp الخلفية التي تمت إضافتها في أغسطس 2025.

ما لا يقدمه LocalAI

إذا كان هدفك هو الدردشة مع نموذج محلي بأقل قدر من الإعداد، فاستخدم Ollama أو LM Studio. كلاهما يتمتع بتجربة بدء استخدام أكثر سلاسة، وتجربة أفضل على نظام Windows، وتطبيقات واجهة مستخدم رسومية (GUI) مخصصة. يتفوق سحب النموذج بأمر واحد في Ollama على تكوين YAML في LocalAI لأي شخص لا يقوم ببناء تكامل برمجي.

إذا كان هدفك هو خدمة الإنتاج لمئات المستخدمين المتزامنين، فاستخدم vLLM. تنتج بنية PagedAttention الخاصة به إنتاجية تعادل 5 إلى 20 ضعفاً لأي بيئة تشغيل تعتمد على llama.cpp على نطاق واسع، ولا يتنافس LocalAI في هذه الفئة حسب تصميمه.

يتطلب LocalAI أيضاً الإلمام بنظامي Linux أو macOS. فهو يعمل على نظام Windows عبر WSL أو Docker Desktop، لكن مشكلات GitHub توثق ما يكفي من الاحتكاكات الخاصة بنظام Windows بحيث لا يُعد المسار الموصى به للمستخدمين الذين يعتمدون على Windows بشكل أساسي. إذا كنت تقوم بتشغيل سير عمل مكتبي يعتمد على واجهة المستخدم الرسومية (GUI) أولاً على نظام Windows، فإن LM Studio هو الخيار الأنسب.

أخيراً، LocalAI ليس خدمة مُدارة. لا يوجد دعم من البائع، ولا اتفاقية مستوى خدمة (SLA)، ولا خيار احتياطي مستضاف. المجتمع نشط ويتم الاستجابة لمشكلات GitHub، ولكن إذا واجهت خطأً برمجياً معيقاً بعد ظهر يوم الجمعة، فستكون بمفردك حتى استجابة المشرف التالية.