مشاركة عبر

Get started مع Foundry Local

مهم

  • يتوفر Foundry Local في المعاينة. توفر إصدارات المعاينة العامة access مبكرا إلى الميزات التي يتم نشرها بنشاط.
  • يمكن أن تتغير الميزات والنهج والعمليات أو لديها قدرات محدودة، قبل التوفر العام (GA).

هذا الدليل يوضح لك كيفية إعداد Foundry Local لتشغيل نماذج الذكاء الاصطناعي على جهازك.

المتطلبات المسبقه

يجب أن يفي نظامك بالمتطلبات التالية لتشغيل Foundry Local:

  • نظام التشغيل: Windows 10 (x64)، Windows 11 (x64/ARM)، ويندوز سيرفر 2025، macOS.
  • الأجهزة: 8 جيجابايت من ذاكرة الوصول العشوائي (RAM) بحد أدنى و3 جيجابايت مساحة خالية على القرص. يوصى بذاكرة وصول عشوائي (RAM) تبلغ 16 جيجابايت ومساحة خالية على القرص تبلغ 15 جيجابايت.
  • الشبكة: اتصال بالإنترنت لنماذج التحميل ومزودي التنفيذ. بعد تحميل نموذج، يمكنك تشغيل النماذج المخزنة مؤقتا دون اتصال.
  • التسريع (اختياري): بطاقة رسومات NVIDIA (سلسلة 2000 أو أحدث)، وحدة معالجة رسومات AMD (سلسلة 6000 أو أحدث)، وحدة معالجة معالجة الرسومات من AMD، وحدة معالجة رسومات Intel، وحدة معالجة التقنية Intel (ذاكرة 32 جيجابايت أو أكثر)، معالج Qualcomm Snapdragon X Elite (ذاكرة 8 جيجابايت أو أكثر)، وحدة معالجة التقنية من كوالكوم، أو شرائح آبل.

لتثبيت Foundry Local باستخدام الأوامر في هذا البدء السريع:

  • على ويندوز، تأكد winget من توفرها.
  • على macOS، قم بتثبيت Homebrew إذا استخدمت الخيار brew .

‏‫ملاحظة‬

يتم دعم وحدات NPU الجديدة فقط على الأنظمة التي تعمل بنظام التشغيل Windows 24H2 أو أحدث. إذا كنت تستخدم وحدة معالجة الرسومات Intel NPU على Windows، فقم بتثبيت برنامج تشغيل Intel NPU لتمكين تسريع NPU في Foundry Local.

تأكد من أن لديك حقوق المسؤول لتثبيت البرنامج.

نصيحة

إذا رأيت خطأ في اتصال الخدمة بعد التثبيت (على سبيل المثال، "فشل طلب الخدمة المحلية")، فقم بتشغيل foundry service restart.

تشغيل سريع

Get started بسرعة مع Foundry Local:

الخيار 1: إعداد واجهة سطر الأوامر (CLI) السريع

  1. قم بتثبيت Foundry Local.

    • ويندوز: افتح طرفية وشغل الأمر التالي. 
      winget install Microsoft.FoundryLocal
    • macOS: افتح طرفية وشغل الأمر التالي. 
      brew tap microsoft/foundrylocal
brew install foundrylocal
      بدلا من ذلك، يمكنك تحميل المثبت من مستودع GitHub Foundry المحلي.

    المصدر: توثيق فاوندري المحلي

  2. تحقق من التركيب. Run:

    foundry --version

    يجب أن ترى رقم النسخة المثبتة.

    المصدر: مرجع CLI المحلي في Foundry

  3. قم بتشغيل النموذج الأول. افتح طرفا طرفيا وقم بتشغيل هذا الأمر:

    foundry model run qwen2.5-0.5b

    يقوم Foundry Local بتنزيل النموذج ، والذي قد يستغرق بضع دقائق حسب سرعة الإنترنت لديك ، ثم يقوم بتشغيله. بعد بدء تشغيل النموذج، تفاعل معه باستخدام واجهة سطر الأوامر (CLI). على سبيل المثال، يمكنك سؤال:

    Why is the sky blue?

    ترى استجابة من النموذج في المحطة الطرفية: لقطة شاشة للإخراج من أمر التشغيل المحلي Foundry.

المصدر: مرجع CLI المحلي في Foundry

الخيار 2: تنزيل المشاريع المبتدئة

للتعلم العملي والعملي، قم بتحميل أحد المشاريع المبدئية التي تعرض سيناريوهات واقعية:

يشمل كل project:

  • تعليمات الإعداد خطوة بخطوة
  • كود المصدر الكامل
  • أمثلة على التكوين
  • أفضل الممارسات

نصيحة

تتماشى هذه المشاريع الابتدائية مع سيناريوهات how to guides وتوفر قيمة عملية فورية.

نصيحة

استبدل qwen2.5-0.5b بأي اسم طراز من الكتالوج (قم بالتشغيل foundry model list لعرض النماذج المتوفرة). يقوم Foundry Local بتنزيل المتغير الذي يتناسب بشكل أفضل مع تكوين الأجهزة والبرامج في نظامك. على سبيل المثال، إذا كان لديك وحدة معالجة رسومات NVIDIA، فإن Foundry Local يقوم بتنزيل إصدار CUDA. إذا كان لديك وحدة معالجة تقنية Qualcomm NPU ، فإن Foundry Local تقوم بتنزيل متغير NPU. إذا لم يكن لديك GPU أو NPU ، فسيقوم Foundry Local بتنزيل إصدار وحدة المعالجة المركزية.

عند التشغيل foundry model list في المرة الأولى ، سترى شريط تقدم التنزيل بينما يقوم Foundry Local بتنزيل موفري التنفيذ لأجهزتك.

المصدر: مرجع CLI المحلي في Foundry

استكشاف الأوامر

ينظم Foundry CLI الأوامر في هذه الفئات الرئيسية:

  • النموذج: أوامر لإدارة النماذج وتشغيلها.
  • الخدمة: أوامر لإدارة خدمة Foundry المحلية.
  • ذاكرة التخزين المؤقت: أوامر لإدارة ذاكرة التخزين المؤقت للنموذج المحلي (النماذج التي تم تنزيلها على القرص المحلي).

لعرض جميع الأوامر، استخدم:

foundry --help

foundry model --help

المسبك -- المساعدة

foundry service --help

عرض أوامر ذاكرة التخزين المؤقت :

foundry cache --help

المصدر: مرجع CLI المحلي في Foundry

اختياري: تشغيل أحدث طراز GPT OSS 20B

تشغيل النموذج gpt-oss-20b :

foundry model run gpt-oss-20b

مهم

إذا لم يكن النموذج متاحا لجهازك، شغل نموذجا أصغر (على سبيل المثال، qwen2.5-0.5b).

بالنسبة لنسخة CUDA، عادة تحتاج إلى بطاقة رسومات NVIDIA بذاكرة VRAM بسعة 16 جيجابايت أو أكثر.

تضيف نسخة Foundry Local 0.6.87 أو أحدثها دعم لهذا الطراز. تحقق من نسختك باستخدام:

foundry --version

المصدر: مرجع CLI المحلي في Foundry

نصيحة

للحصول على تفاصيل حول جميع أوامر CLI، راجع مرجع واجهة سطر الأوامر المحلية Foundry.

ترقية مسبك محلي

قم بتشغيل الأمر الخاص بنظام التشغيل الخاص بك لترقية Foundry Local.

  • Windows: في محطة طرفية، قم بتشغيل: 
    winget upgrade --id Microsoft.FoundryLocal
  • macOS: في محطة طرفية، قم بتشغيل: 
    brew upgrade foundrylocal

إلغاء تثبيت مسبك محلي

لإلغاء تثبيت Foundry Local ، قم بتشغيل الأمر لنظام التشغيل الخاص بك:

  • Windows: افتح وحدة طرفية وقم بتشغيل: 
    winget uninstall Microsoft.FoundryLocal
  • macOS: افتح وحدة طرفية وقم بتشغيل: 
    brew rm foundrylocal
brew untap microsoft/foundrylocal
brew cleanup --scrub

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

مشاكل اتصال الخدمة

إذا رأيت هذا الخطأ عند التشغيل foundry model list أو أمر مشابه:

foundry model list

Exception: Request to local service failed.
Uri: http://127.0.0.1:0/foundry/list

The requested address is not valid in its context. (127.0.0.1:0)

Please check service status with 'foundry service status'.

قم بتشغيل هذا الأمر لإعادة تشغيل الخدمة:

foundry service restart

تصلح هذه الأوامر الحالات التي تعمل فيها الخدمة ولكن لا يمكن الوصول إليها بسبب مشكلة ربط المنفذ.

مرجع: أفضل الممارسات وحل المشكلات

المحتوى ذو الصلة

  • Last updated on