بدء التشغيل السريع: تثبيت HUB-SDK

أهلاً ومرحباً بك! 🎉 إذا كنت تتطلع إلى التكامل مع خدمات Ultralytics بسرعة وبدون متاعب، فقد وصلت إلى المكان الصحيح. صُمم دليل تثبيت HUB-SDK الخاص بنا لمساعدتك على البدء في العمل في أسرع وقت من خلال تعليمات واضحة خطوة بخطوة. سواء كنت مطورًا متمرسًا أو مبتدئًا، فإن هدفنا هو تزويدك بعملية إعداد سهلة ومباشرة. لذا أحضر مشروبك المفضل، ودعنا نبدأ رحلة التثبيت هذه معًا!

المتطلبات الأساسية

قبل أن نتعمق في جوهر عملية التثبيت، دعنا نتأكد من أن لدينا جميع الأدوات التي سنحتاجها. تبدأ عملية التثبيت السلس بالإعداد الصحيح، لذا إليك ما يجب أن يكون في متناول يدك:

Python: من الضروري أن يكون لديك Python مثبتًا على جهازك للعمل مع HUB-SDK. قم بتنزيل أحدث إصدار من python.org إذا لم يكن مثبتًا بالفعل على نظامك.
Git (اختياري): على الرغم من أن Git ليس إلزاميًا لتثبيت HUB-SDK، إلا أنه يوصى به بشدة إذا كنت ترغب في الحصول على أحدث الميزات وأروعها مباشرةً من المصدر. يمكن الحصول على Git من git-scm.com.

بعد الانتهاء من هذه المتطلبات الأساسية، تكون مستعداً للانتقال إلى مرحلة التثبيت.

طرق التثبيت

اعتمادًا على احتياجاتك، يمكنك الاختيار بين طريقتين أساسيتين لتثبيت HUB-SDK. إليك ما يقدمه كل مسار:

التثبيت من PyPI

إذا كنت تبحث عن الاستقرار وسهولة التثبيت، فإن الحصول على أحدث إصدار مستقر من HUB-SDK من PyPI هو السبيل الأمثل. إليك كيفية القيام بذلك باستخدام pip، مثبت الحزمة Python:

pip install hub-sdk

سيؤدي تشغيل هذا الأمر إلى سحب الإصدار المستقر من HUB-SDK وتثبيته مباشرةً في بيئة Python الخاصة بك. إنه أسرع طريق لبدء استخدام HUB-SDK.

تهيئة HUBClient

بمجرد اكتمال التثبيت، حان الوقت لوضع يديك على HUBClient. سيكون HUBClient هو بوابتك للتواصل مع النظام البيئي Ultralytics . يمكنك العثور أدناه على طريقتين لمصادقة العميل واستخدامه.

الخيار أ: استخدام مفتاح واجهة برمجة التطبيقات للمصادقة

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

credentials = {"api_key": "<YOUR-API-KEY>"}

أدخل مفتاح واجهة برمجة التطبيقات الفعلي الذي يوفره لك Ultralytics بدلاً من <YOUR-API-KEY>. هذه هي الطريقة المفضلة عندما تتطلب واجهات برمجة التطبيقات مفتاحًا آمنًا للوصول.

الخيار ب: استخدام زوج بريد إلكتروني/كلمة مرور للمصادقة

إذا كنت بحاجة إلى استخدام تركيبة بريد إلكتروني/كلمة مرور، فالأمر بنفس البساطة:

credentials = {"email": "<YOUR-EMAIL>", "password": "<YOUR-PASSWORD>"}

استبدل <YOUR-EMAIL> و <YOUR-PASSWORD> مع بيانات اعتماد تسجيل الدخول الخاصة بك. هذا النهج أكثر تقليدية ولكنه قوي بنفس القدر.

أخيراً، قم بإنشاء كائن HUBClient باستخدام أسلوب الاعتماد الذي اخترته:

مصادقة HUB SDK

المصادقة باستخدام مفتاح APIالمصادقة باستخدام البريد الإلكتروني وكلمة المرور

from hub_sdk import HUBClient

credentials = {"api_key": "<YOUR-API-KEY>"}  # api key
client = HUBClient(credentials)

from hub_sdk import HUBClient

credentials = {"email": "<YOUR-EMAIL>", "password": "<YOUR-PASSWORD>"}  # email and password
client = HUBClient(credentials)

من خلال تنفيذ سطر التعليمات البرمجية أعلاه، تكون قد أنشأت بنجاح مثيلًا ل HUBClient، وجاهزًا لتنفيذ عمليات مختلفة باستخدام خدمات Ultralytics !

أنت جاهز! 🚀 أصبح لديك الآن HUB-SDK مثبتًا و HUBClient مهيأ تحت تصرفك. من هنا، يمكنك البدء في الغوص في الميزات الغنية التي يوفرها النظام البيئي Ultralytics . استفد من قوة ومرونة HUB-SDK لمشاريعك، وتصفح الوثائق لاستكشاف المزيد مما يمكنك القيام به، وإذا واجهت أي مشاكل، فإن فريق الدعم الودود لدينا على بعد نقرة واحدة فقط. ترميز سعيد!