Hugging Face Hub
يتكامل Libre WebUI مع Hugging Face بطريقتين:
- الوصول عبر إضافة موفّر من خلال Hugging Face Inference Providers.
- تصفح Hub من داخل التطبيق للنماذج المتوافقة، بما فيها نماذج GGUF التي يمكن سحبها عبر Ollama.
إعداد إضافة الموفّر
أنشئ رمز وصول إلى Hugging Face بصلاحية الاستدلال، ثم أضفه في الإعدادات أو كمتغير بيئة:
HUGGINGFACE_API_KEY=hf_...
فعّل إضافة Hugging Face من الإعدادات > الإضافات.
الإمكانات
بحسب توفر النموذج والموفّر، يمكن أن يقدّم Hugging Face:
- نماذج محادثة أو إكمال
- تحويل النص إلى كلام
- توليد الصور
- التضمينات
- تحويل الكلام إلى نص
قد يتغير توفر Hugging Face وأسعاره وتوجيهه بحسب النموذج. راجع صفحة النموذج وواجهة موفّر Hugging Face لمعرفة الحالة الحالية.
متصفح النماذج
يتيح لك المتصفح داخل التطبيق:
- البحث باسم النموذج أو المؤلف.
- التصفية حسب المهمة.
- الفرز حسب الرواج أو التنزيلات أو الإعجابات أو تاريخ الإنشاء أو تاريخ التحديث.
- فحص حالة تقييد الوصول إلى النموذج.
- سحب ملفات GGUF المتوافقة عبر Ollama عندما تكون مدعومة.
يجلب المتصفح بيانات Hub الوصفية عبر وكيل الواجهة الخلفية ويخزّن النتائج مؤقتًا لتحسين الأداء. وتتطلب الواجهة الخلفية جلسة Libre نشطة لاكتشاف محتوى Hub، ولا يمكن مسح ذاكرة النماذج المؤقتة المشتركة إلا لمسؤول حالي.
GGUF وOllama
للاستدلال المحلي، ابحث عن نماذج بصيغة GGUF. يستطيع Libre WebUI استخدام مراجع
النماذج hf.co/... المتوافقة مع Ollama عندما يوفّر المستودع ملفات GGUF مناسبة.
نمط مثال:
ollama run hf.co/owner/model-repo:tag
استخدم الواجهة متى أمكن؛ فهي تقلل أخطاء النسخ واللصق وتُبقي بيانات النموذج الوصفية ظاهرة.
توجيه Inference Provider
يدعم موجّه Hugging Face المتوافق مع OpenAI معرّفات النماذج من Hub. وتدعم بعض المسارات لواحق أو تفضيلات للموفّر. ولأن ذلك يتغير بمرور الوقت، فاعتمد على أحدث مستندات Hugging Face ومتصفح النماذج داخل التطبيق لمعرفة معرّفات النماذج الدقيقة.
النماذج مقيّدة الوصول
تتطلب بعض النماذج قبول شروط قبل الاستخدام:
- افتح صفحة النموذج على Hugging Face.
- اقبل الترخيص أو الشروط.
- تأكد من أن رمزك يملك حق الوصول.
- أعد المحاولة من Libre WebUI.
قد تظهر النماذج مقيّدة الوصول في الاكتشاف قبل السماح لرمزك بتشغيلها.
استكشاف الأخطاء وإصلاحها
غير مصرح
- تحقق من قيمة الرمز.
- تأكد من أن الرمز يملك صلاحيات الاستدلال.
- إذا كنت تستخدم بيانات اعتماد لكل مستخدم، فتأكد من حفظ المفتاح للمستخدم الحالي.
النموذج غير متاح
- راجع صفحة نموذج Hugging Face.
- جرّب مسار موفّر آخر إن كان متاحًا.
- تأكد من قبول شروط الوصول المقيّد.
فشل سحب GGUF
- تأكد من أن المستودع يحتوي على ملفات GGUF.
- جرّب مرجع
hf.co/...الدقيق في طرفية باستخدام Ollama. - استخدم تكميمًا أصغر إذا كانت مساحة القرص أو الذاكرة محدودة.