البدء السريع
المتطلبات
| المتطلب | الحد الأدنى | الموصى به |
|---|---|---|
| Node.js | 22.22+ | أحدث إصدار LTS |
| RAM | 8 GB | 16 GB+ |
| القرص | 5 GB | 20 GB+ للنماذج |
| GPU | اختياري | 8 GB+ من VRAM للاستدلال المحلي السريع |
| Docker | اختياري | مطلوب لمهام Work |
يعمل Libre WebUI مع Ollama باستخدام CPU فقط، لكن النماذج الأصغر أنسب لهذا الاستخدام. أما مكوّنات الموفّرين السحابيين الإضافية فلا تحتاج سوى إلى مفتاح API ذي الصلة.
لا تتطلب المحادثات والمستندات والعناصر التفاعلية والميزات المعتمدة على الموفّرين وجود Docker.
لكن Work يتطلبه: يجب تثبيت Docker على الجهاز الذي يشغّل خادم Libre WebUI الخلفي،
ويجب السماح لعملية الخادم الخلفي باستدعائه. لا تثبّت الأمر
npx libre-webui أداة Docker. وإذا لم يكن Docker متاحًا، يستمر باقي
Libre WebUI في العمل بينما تعرض Work رسالة بيئة التشغيل غير متاحة؛
ولا تُنفَّذ أوامر النموذج مباشرة على المضيف بوصف ذلك مسارًا احتياطيًا.
تشغيل Libre WebUI
npx libre-webui@latest
افتح http://localhost:8080. أنشئ الحساب الأول؛
وسيصبح هذا الحساب المسؤول. تظل التسجيلات العامة اللاحقة
معطلة ما لم تضبط ENABLE_SIGNUP=true صراحةً.
يحتفظ المشغّل المضمّن بالحالة الدائمة في ~/.libre-webui. اضبط
DATA_DIR على مسار مطلق لاختيار موقع آخر؛ وتُحل القيم النسبية
بدءًا من الدليل الذي تشغّل فيه npx.
تثبيت Ollama
ثبّت Ollama، ثم نزّل نموذجًا عامًا صغيرًا:
ollama pull gemma4:12b
من الخيارات القوية الأخرى gemma4:26b (MoE)، وgemma4:31b (dense)، وqwen3.8:27b. استخدم مدير النماذج في Libre WebUI لاستعراض النماذج المثبّتة والبحث مباشرةً في مكتبة Ollama وتنزيل النماذج من دون مغادرة التطبيق.
للبحث الدلالي في المستندات، ثبّت أيضًا نموذج تضمينات:
ollama pull nomic-embed-text
إضافة موفّرين سحابيين
الموفّرون السحابيون اختياريون. أضف المفاتيح لكل مستخدم في الإعدادات ← مفاتيح API، أو
على مستوى الخادم في backend/.env (ثم أعد تشغيل الخادم الخلفي)، وبعدها فعّل
الموفّر من الإعدادات:
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...
GEMINI_API_KEY=...
OPENROUTER_API_KEY=sk-or-...
KIMI_API_KEY=...
يحدّث التطبيق قوائم نماذج الموفّرين عندما يكون ذلك مدعومًا. لا تحتاج إلى إبقاء المستندات مفتوحة لمعرفة أحدث أسماء النماذج.
بدء أول مهمة Work
تمنح Work كل مهمة محادثة دائمة ونظام ملفات مستقلًا مدعومًا بحاوية. وتتاح هذه الميزة للمسؤولين المسجّلين دخولهم.
- ثبّت Docker وشغّله على الجهاز الذي يشغّل خادم Libre WebUI الخلفي.
- ابدأ مهمة من زر Work في رأس الشريط الجانبي، أو من قائمة
+في شريط علامات التبويب، أو الصفحة الرئيسية، أوCmd/Ctrl + Shift + U. - اختر نموذجًا يدعم استدعاء الأدوات.
- صِف ما تريد بناءه أو تغييره، ثم اختر تشغيل.
- تابع النتيجة في علامات الملفات والنشاط وGit والطرفية والمعاينة ضمن جزء مساحة العمل.
تظل المهمة في الشريط الجانبي كي تتمكن من العودة إلى المحادثة نفسها وملفاتها لاحقًا. يؤدي إيقاف تشغيل أو معاينة إلى الحفاظ على مساحة العمل، أما حذف المهمة فيحذف مساحة عملها نهائيًا.
يمكن لـ Work استخدام نموذج Ollama مثبّت، أو نموذج Ollama Cloud، أو مكوّن إضافي مضبوط لموفّر محادثة أو إكمال. عند اختيار موفّر بعيد، يعرض Libre WebUI إفصاحًا قبل التشغيل: يتلقى الموفّر المحادثة وتعريفات الأدوات وأي نتائج أدوات يطلبها النموذج. وقد يُجري التشغيل الذاتي عدة استدعاءات مدفوعة إلى الموفّر.
راجع Work: مساحات العمل المعزولة لمعرفة تفاصيل بيئة التشغيل والاستمرارية والشبكة والمعاينة والأمان.
Docker
git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d
أنشئ المسؤول الأول في المتصفح. لا يلزم أي علم للتسجيل أو إعادة تشغيل؛ فالتسجيل العام اللاحق مغلق افتراضيًا.
إذا كان Ollama يعمل بالفعل على المضيف أو على جهاز آخر:
docker compose -f docker-compose.external-ollama.yml up -d
لتسريع GPU من NVIDIA، استخدم ملف Compose الخاص بـ GPU الذي يوفره المستودع.
تربط ملفات Compose في المستودع مقبس Docker الخاص بالمضيف كي تتاح Work عند
تثبيت Docker. يمنح ذلك التطبيق تحكمًا بالمضيف مكافئًا لصلاحيات root، لذا اقرأ
Work: مساحات العمل المعزولة أولًا. على Linux، اضبط
DOCKER_GID في .env على المجموعة المالكة للمقبس. أزل الربط إن لم تكن
Work مطلوبة.
كما أن Ollama المضمّن داخلي فقط. أضف
-f docker-compose.ollama-host.yml فقط عندما تحتاج عملية أخرى على المضيف إلى API الخاص به؛
ويرتبط ملف التجاوز افتراضيًا بواجهة loopback.
التعرّف على الواجهة
تضم علامة الرئيسية ثلاثة أقسام: ابدأ (محادثة جديدة، محادثة خفية، مهمة
Work جديدة)، وتابع (محادثاتك ومهامك الأخيرة)، واستكشف
(الملاحظات، التقويم، الأتمتة، النماذج، الشخصيات، Imagine). وتوجد الوجهات
نفسها في صف التنقل بالشريط الجانبي وفي لوحة الأوامر
(Cmd/Ctrl + K) التي تجري بحثًا تقريبيًا في محادثاتك ومهام Work وإجراءات
التطبيق، وبحثًا نصيًا كاملًا في محتوى رسائلك وملاحظاتك ومستنداتك.
- التقويم — تقويم لكل مستخدم يدعم الأحداث المتكررة.
- الأتمتة — عمليات AI مجدولة تُسلَّم في جلسات محادثة.
اختصارات لوحة المفاتيح
| الاختصار | الإجراء |
|---|---|
Cmd/Ctrl + K | لوحة الأوامر (تعمل أثناء الكتابة) |
Cmd/Ctrl + Shift + O | محادثة جديدة |
Cmd/Ctrl + Shift + U | مهمة Work جديدة |
Cmd/Ctrl + B | إظهار الشريط الجانبي أو إخفاؤه |
Cmd/Ctrl + , | الإعدادات |
Cmd/Ctrl + D | تبديل السمة |
? | فتح الإعدادات على علامة الاختصارات |
Esc | إغلاق نافذة الإعدادات |
Enter | إرسال الرسالة |
Shift + Enter | سطر جديد |