الدرس 5 من 6

تثبيت Ollama

نثبّت Ollama على Windows أو macOS أو Linux، ثم نقوم بتحميل النموذج qwen2.5:0.5b ونتأكد أنه يعمل على جهازك.

5 دقائق للقراءة

في درس ما النموذج المحلي؟ عرفنا أن Ollama مشغّل النماذج، وأننا سنستخدم النموذج qwen2.5:0.5b، وهو الأنسب للأجهزة قليلة الموارد.

في هذا الدرس نثبّت Ollama على جهازك، ثم نقوم بتحميل النموذج ونتأكد أنه يعمل.

ما يحتاجه جهازك

نستخدم النموذج qwen2.5:0.5b، وهو أصغر أحجام Qwen2.5، فهو الأنسب للأجهزة قليلة الموارد. وهذا ما تحتاج إليه لتجرّب:

ما تحتاج إليه التفصيل
النظام Windows 10 الإصدار 22H2 أو أحدث، أو macOS Sonoma (14) أو أحدث، أو Linux
المساحة نحو 4 غيغابايت لتثبيت Ollama على Windows، كما تقول وثائقه، ونحو 398 ميغابايت للنموذج
بطاقة الرسوميات لا تلزم. يعمل Ollama على المعالج، لكن الجواب يكون أبطأ
الإنترنت عند تنزيل Ollama والنموذج فقط. بعد ذلك يعمل دونه

نصيحة: تشغيل النموذج يرفع استخدام المعالج، فالأفضل أن توصل اللابتوب بسلك الشاحن مباشرة، ولا تعتمد على بطاريته فقط.

ولا تذكر وثائق Ollama حدًّا أدنى للذاكرة لهذا النموذج. وهو يُحمَّل في الذاكرة حين تسأله، ويُخرَج منها بعد خمس دقائق من آخر طلب.

اختر نظامك

الخطوات تختلف قليلًا من نظام إلى آخر. اطلع على قسم نظام التشغيل الذي تستخدمه، ثم ارجع إلى قسم «تحميل النموذج والتأكد» فهو واحد للجميع.

ثلاث طرق، ونتيجة واحدةWindowsمثبّت أوأمر PowerShellmacOSملف dmgتسحبه إلى التطبيقاتLinuxأمر واحدفي الطرفيةollama -vثم ننزّل النموذجاختر نظامك، ثم تأكد بالأمر نفسه
ثلاث طرق لتثبيت Ollama: في Windows مثبّت أو أمر PowerShell، وفي macOS ملف dmg، وفي Linux أمر واحد في الطرفية، ثم تتأكد من التثبيت بالأمر ollama –version.

ملاحظة حول المصادر

أقسام Windows وmacOS في هذا الدرس مأخوذة من وثائق Ollama الرسمية، ولم أجرّبها على هذين النظامين. وقسم Linux جرّبته على Debian 13.

التثبيت على Windows

المتطلبات: Windows 10 الإصدار 22H2 أو أحدث. ولا يحتاج التثبيت إلى صلاحيات المدير، فهو يثبّت Ollama في مجلد مستخدمك.

لديك طريقتان:

  1. المثبّت: نزّل ملف OllamaSetup.exe من صفحة التحميل، ثم شغّله كأي تطبيق.
  2. الأمر: افتح PowerShell وشغّل:
irm https://ollama.com/install.ps1 | iex

بعد التثبيت يعمل Ollama في الخلفية، ويصبح الأمر ollama متاحًا في cmd وPowerShell. افتح نافذة طرفية جديدة بعد التثبيت، لأن النوافذ المفتوحة السابقة لا ترى الأمر بعد.

أين يوضع Ollama على جهازك، :

ما هو المسار
ملفات Ollama %LOCALAPPDATA%\Programs\Ollama
النماذج والإعدادات %HOMEPATH%\.ollama
سجلات التشغيل %LOCALAPPDATA%\Ollama

وللإزالة: من إعدادات Windows، ثم «التطبيقات»، ثم «إضافة التطبيقات أو إزالتها».

التثبيت على macOS

المتطلبات: macOS Sonoma (الإصدار 14) أو أحدث، على معالج Apple من فئة M، أو على معالج Intel (ويعمل عندئذ على المعالج فقط، بلا دعم لبطاقة الرسوميات).

  1. نزّل ملف Ollama.dmg من صفحة التحميل.
  2. افتحه، ثم اسحب Ollama إلى مجلد Applications.
  3. شغّل Ollama. في أول تشغيل يتأكد من وجود الأمر ollama في طرفيتك، وإن لم يجده طلب إذنك لينشئ رابطًا في /usr/local/bin. وافق.

وتحفظ النماذج والإعدادات في المجلد ~/.ollama.

التثبيت على Linux

على Linux يكفي أمر واحد في الطرفية:

curl -fsSL https://ollama.com/install.sh | sh

يشغّل هذا الأمر مثبّتًا من موقع Ollama الرسمي، فاستخدمه إن كنت مرتاحًا لذلك. ويطلب المثبّت كلمة مرورك لأنه يستخدم sudo.

أين تجد النماذج؟

يعمل Ollama على Linux خدمةً باسم ollama، ويحفظ النماذج في:

/usr/share/ollama/.ollama/models

وإن حاولت أن تفتح هذا المجلد فستظهر رسالة permission denied. هذا طبيعي، لأن المجلد يخص مستخدم Ollama. استخدم sudo للاطلاع فقط، ولا تحذف ملفات من المجلد يدويًّا.

وهذه أوامر مفيدة لإدارة الخدمة:

sudo systemctl status ollama
sudo systemctl stop ollama
sudo systemctl start ollama

تحميل النموذج

هذا القسم واحد لكل الأنظمة. افتح طرفية جديدة.

الخطوة 1: تأكد أن Ollama مثبّت:

ollama --version

يجب أن يظهر رقم الإصدار. فإن قال إن الأمر غير موجود، فراجع قسم «إن لم يعمل شيء».

مثال على ما يظهر:

ollama version is 0.40.13

الخطوة 2: قم بتحميل النموذج. حجمه نحو غيغابايت، فقد يستغرق دقائق بحسب سرعة الإنترنت:

ollama pull qwen2.5:0.5b

الخطوة 3: تأكد أن تم تحميله:

ollama list

يجب أن ترى qwen2.5:0.5b في القائمة، مع حجمه.

مثال على ما يظهر:

NAME            ID              SIZE      MODIFIED
qwen2.5:0.5b    a1b2c3d4e5f6    398 MB    2 hours ago
  • NAME: اسم النموذج.
  • ID: رقم تعريف النموذج. هو مثال هنا، ويختلف عندك.
  • SIZE: حجم الملف.
  • MODIFIED: متى تم تحميل النموذج.

الخطوة 4: حاوره مباشرة:

ollama run qwen2.5:0.5b

اكتب سؤالًا قصيرًا، مثل say hello in 3 words، واقرأ جوابه.

وللخروج من المحادثة مع النموذج، اكتب:

/bye

ماذا تلاحظ؟

  • هل ظهر رقم الإصدار في الخطوة 1؟
  • هل ظهر qwen2.5:0.5b في الخطوة 3؟
  • هل أجاب النموذج؟ وهل التزم بالكلمات الثلاث؟

ما ظهر لي حين جرّبتُ

~$ ollama run qwen2.5:0.5b
>>> say hello in 3 words
Hello there!

>>> Send a message (/? for help)

طلبتُ ثلاث كلمات فأجاب بكلمتين: Hello there!. هذا نموذج صغير، وقد لا يلتزم بالعدد المطلوب. والمهم أنه يعمل على جهازي.

إن لم يعمل شيء

ما يظهر لك السبب المحتمل الحل
command not found أو أن الأمر غير معروف الطرفية فُتحت قبل التثبيت أغلقها وافتح نافذة جديدة
permission denied على Linux المجلد يخص مستخدم Ollama استخدم sudo للاطلاع فقط
لا يجيب النموذج أو لا يتصل الخدمة متوقفة على Linux: sudo systemctl start ollama، أو شغّل ollama serve في طرفية منفصلة
الجهاز بطيء أو يتجمّد أثناء الجواب الجهاز ضعيف أو ذاكرته قليلة أغلق التطبيقات الأخرى لتوفّر الذاكرة

اختبر نفسك

فتحتَ طرفية Windows، ثم ثبّتَ Ollama، ثم كتبتَ ollama --version في الطرفية نفسها فقالت إن الأمر غير معروف. ما الحل؟

اعرض الجواب

أغلق الطرفية وافتح نافذة جديدة. الطرفية التي فُتحت قبل التثبيت لا ترى الأمر الجديد.

ما الذي تعلّمناه؟

  • يتم تثبيت مشغل النماذج ollama على نظام التشغيل الخاص بك
  • بعد التثبيت نتأكد بـ ollama --version.
  • نقوم بتحميل النموذج بـ ollama pull qwen2.5:0.5b، ونتأكد منه بـ ollama list.
  • نحاور النموذج مباشرة بـ ollama run qwen2.5:0.5b، ونخرج بـ /bye.

المصادر:

في الدرس القادم نبدأ ببناء الوكيل.