يعمل Ollama كتطبيق أصلي لنظام ويندوز، مع دعم لبطاقات NVIDIA و AMD Radeon GPU. بعد تثبيت Ollama على ويندوز، سيعمل Ollama في الخلفية، وستكون واجهة سطر الأوامر ollama متاحة في cmd أو powershell أو أي تطبيق طرفية تفضله. وكالعادة، سيتم تقديم API الخاص بـ Ollama على العنوان http://localhost:11434.

متطلبات النظام

• Windows 10 22H2 أو أحدث، الإصدارات Home أو Pro
• برامج تشغيل NVIDIA 551.61 أو أحدث إذا كان لديك بطاقة NVIDIA
• حزمة برامج تشغيل AMD ROCm v7 / HIP7 المتوافقة لتسريع ROCm، أو برامج تشغيل AMD Radeon متوافقة مع Vulkan لتسريع Vulkan

يستخدم Ollama أحرف Unicode كمؤشر للتقدم، وقد تظهر كمربعات غير معروفة في بعض خطوط الطرفية القديمة في ويندوز 10. إذا رأيت هذا، فحاول تغيير إعدادات خط الطرفية الذي تستخدمه.

ملاحظة

بعض أنظمة RDNA2 / Radeon RX 6000، بما في ذلك بطاقات فئة RX 6800، قد لا تدعم ROCm v7 في برامج تشغيل AMD الحالية لويندوز. يتم تفعيل Vulkan بشكل افتراضي وهو الخيار الاحتياطي الموصى به لهذه الأنظمة. إذا كان نظامك يحتوي على iGPU و dGPU مختلط وتم اختيار Vulkan لـ iGPU غير مستقر، عيّن المتغير GGML_VK_VISIBLE_DEVICES إلى فهرس GPU المنفصل.

متطلبات نظام الملفات

لا يتطلب تثبيت Ollama صلاحيات المسؤول، ويتم تثبيته في دليل المستخدم الرئيسي بشكل افتراضي. ستحتاج إلى مساحة تخزين لا تقل عن 4 جيجابايت لتثبيت الملفات التنفيذية. بعد تثبيت Ollama، ستحتاج إلى مساحة إضافية لتخزين نماذج اللغة الكبيرة، التي قد يصل حجمها من عشرات إلى مئات الجيجابايت. إذا لم يكن دليل المستخدم الرئيسي لديك يحتوي على مساحة كافية، يمكنك تغيير موقع تثبيت الملفات التنفيذية وموقع تخزين النماذج.

تغيير موقع التثبيت

لتثبيت تطبيق Ollama في موقع مختلف عن دليل المستخدم الرئيسي، ابدأ برنامج التثبيت مع العلامة التالية

OllamaSetup.exe /DIR="d:\some\location"

تغيير موقع تخزين النماذج

لتغيير موقع تخزين Ollama للنماذج التي تم تنزيلها بدلاً من استخدام دليل المستخدم الرئيسي، عيّن المتغير البيئي OLLAMA_MODELS في حساب المستخدم الخاص بك.

1. ابدأ تطبيق الإعدادات (لويندوز 11) أو لوحة التحكم (لويندوز 10) وابحث عن المتغيرات البيئية.
2. انقر على تعديل المتغيرات البيئية لحسابك.
3. قم بتعديل أو إنشاء متغير جديد لحساب المستخدم الخاص بك باسم OLLAMA_MODELS وحدد الموقع الذي تريد تخزين النماذج فيه
4. انقر على موافق/تطبيق للحفظ.

إذا كان Ollama يعمل بالفعل، فاخرج من تطبيق شريط المهام وأعد تشغيله من قائمة ابدأ، أو من طرفية جديدة تم تشغيلها بعد حفظ المتغيرات البيئية.

الوصول إلى API

إليك مثال سريع يوضح الوصول إلى API من powershell

(Invoke-WebRequest -method POST -Body '{"model":"llama3.2", "prompt":"Why is the sky blue?", "stream": false}' -uri http://localhost:11434/api/generate ).Content | ConvertFrom-json

استكشاف الأخطاء وإصلاحها

يخزن Ollama على ويندوز الملفات في عدة مواقع مختلفة. يمكنك عرضها في نافذة المستكشف بالضغط على <Ctrl>+R وكتابة:

• explorer %LOCALAPPDATA%\Ollama يحتوي على السجلات والتحديثات التي تم تنزيلها
  • app.log يحتوي على أحدث السجلات من تطبيق الواجهة الرسومية
  • server.log يحتوي على أحدث سجلات الخادم
  • upgrade.log يحتوي على مخرجات السجلات الخاصة بالتحديثات
• explorer %LOCALAPPDATA%\Programs\Ollama يحتوي على الملفات التنفيذية (يضيف المثبت هذا المسار إلى متغير PATH الخاص بالمستخدم)
• explorer %HOMEPATH%\.ollama يحتوي على النماذج والتهيئة
• explorer %TEMP% يحتوي على الملفات التنفيذية المؤقتة في دليل واحد أو أكثر من الدلائل التي تبدأ بـ ollama*

إلغاء التثبيت

يسجل مثبت Ollama لويندوز تطبيق إلغاء التثبيت. يمكنك إلغاء تثبيت Ollama من خلال خيار إضافة أو إزالة البرامج في إعدادات ويندوز.

ملاحظة

إذا قمت بتغيير موقع تخزين OLLAMA_MODELS، فلن يقوم المثبت بإزالة النماذج التي قمت بتنزيلها

واجهة الأوامر المستقلة (CLI)

أسهل طريقة لتثبيت Ollama على ويندوز هي استخدام مثبت OllamaSetup.exe. يتم تثبيته في حسابك دون الحاجة إلى صلاحيات المسؤول. نقوم بتحديث Ollama بانتظام لدعم أحدث النماذج، وسيساعدك هذا المثبت على البقاء محدثًا.

إذا كنت ترغب في تثبيت Ollama أو دمجه كخدمة، فهناك ملف zip مستقل ollama-windows-amd64.zip متاح يحتوي فقط على واجهة الأوامر المستقلة (CLI) الخاصة بـ Ollama وتبعيات مكتبات GPU لـ Nvidia. اعتمادًا على عتادك، قد تحتاج أيضًا إلى تنزيل واستخراج حزم إضافية إلى نفس الدليل:

• AMD GPU: ollama-windows-amd64-rocm.zip
• MLX (CUDA): ollama-windows-amd64-mlx.zip

يتيح هذا دمج Ollama في التطبيقات الحالية، أو تشغيله كخدمة نظام عبر الأمر ollama serve باستخدام أدوات مثل NSSM.

ملاحظة

إذا كنت تقوم بالترقية من إصدار سابق، يجب عليك إزالة الدلائل القديمة أولاً.

ملاحظة حول التصحيح الإملائي في النص الأصلي:

النص الأصلي يحتوي على خطأ إملائي في كلمة "resent" في جملة "app.log contains most resent logs"، حيث كانت المقصودة هي "recent" (أحدث)، لذا تمت ترجمتها وفقًا للمعنى المقصود لضمان وضوح المحتوى للقارئ العربي.