Ultralytics HUB-SDK
مرحبًا بك في وثائق Ultralytics HUB-SDK! إذا كنت تتطلع إلى دمج أدوات وخدمات تعلم آلي قوية في تطبيقات Python الخاصة بك، فقد وصلت إلى المكان الصحيح. سواء كنت من عشاق الذكاء الاصطناعي، أو ممارسًا متمرسًا للتعلم الآلي، أو مطور برامج يتطلع إلى تسخير قدرات خدمات Ultralytics، فإن SDK الخاص بنا يجعل الأمر سهلاً وفعالاً.
ستوجهك وثائقنا الودية والمهنية في رحلة من التثبيت إلى إتقان HUB-SDK. هيا بنا ننطلق ونبدأ في الاستفادة من القوة الكاملة لنظام Ultralytics البيئي في مشاريعك!
من أين أبدأ؟
هل أنت مستعد للبدء في استخدام HUB-SDK؟ يقدم دليل البدء السريع الخاص بنا مسارًا مباشرًا لتشغيل SDK في بيئة Python الخاصة بك.
- ادفع بتطويرك إلى الأمام وقم بتبسيط الإعداد الخاص بك عن طريق زيارة صفحة البدء السريع.
التثبيت من PyPI
يمكنك الوصول إلى أحدث إصدار مستقر من HUB-SDK من خلال PyPI. ببساطة نفذ الأمر أدناه في جهازك الطرفي أو shell لإضافة SDK بسلاسة إلى مشروع Python الخاص بك:
pip install hub-sdk
بعد تشغيل هذا الأمر، سيتم تنزيل SDK وتثبيته، مما يفتح قدرات خدمات Ultralytics في تطبيقك.
تهيئة HUBClient
يبدأ التكامل مع خدمات Ultralytics بتهيئة HUBClient
كائن. تخلق هذه الخطوة المحورية جسرًا بين التعليمات البرمجية الخاصة بك وواجهات برمجة التطبيقات الخاصة بنا وتتطلب بيانات اعتماد مناسبة للمصادقة. يمكنك اختيار طريقة مفتاح API القياسية أو استخدام بريدك الإلكتروني وكلمة المرور. فلنقم بإعداده معًا! 🚀
الخيار الأول: استخدام مفتاح API
للاستفادة من بساطة مفتاح API، قم بإعداد قاموس بالمفتاح الخاص بك كما يلي:
# Replace <YOUR-API-KEY> with the actual key provided to you by Ultralytics.
credentials = {"api_key": "<YOUR-API-KEY>"}
يُعد استخدام مفتاح API طريقة مصادقة شائعة ومناسبة للوصول البرمجي. إنه مثالي للسيناريوهات التي يُرغب فيها بدمج مفتاح مباشرةً في إطار عملك للتفاعل السريع والآمن مع الخدمة. إن HUBClient
الفئة يرث قدرات المصادقة من Auth
class.
الخيار الثاني: استخدام البريد الإلكتروني وكلمة المرور
هل تفضل استخدام بيانات اعتماد حسابك؟ قم بتكوين HUBClient
مع بريدك الإلكتروني وكلمة المرور الخاصين بك في قاموس بيانات الاعتماد:
# Replace <YOUR-EMAIL> with your email address and <YOUR-PASSWORD> with your password.
credentials = {"email": "<YOUR-EMAIL>", "password": "<YOUR-PASSWORD>"}
يُعد استخدام بريدك الإلكتروني وكلمة مرورك خيارًا مناسبًا إذا كنت تبحث عن تجربة تسجيل دخول تقليدية أو تهدف إلى استخدام ميزات مخصصة مرتبطة بحساب Ultralytics الخاص بك.
الجمع بين كل شيء
الآن بعد أن تم إعداد بيانات الاعتماد الخاصة بك، ابدأ HUBClient
:
مصادقة HUB SDK
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. مع وجود تفاصيل المصادقة الخاصة بك في مكانها بشكل آمن، أنت على استعداد تام لاستكشاف الوظائف في متناول يدك! إن login
طريقة يتعامل مع المصادقة باستخدام بيانات الاعتماد المقدمة.
وظائف HUB-SDK
توفر Ultralytics HUB-SDK مجموعة من الوظائف للتفاعل مع مشاريع تعلم الآلة الخاصة بك. فيما يلي بعض العمليات الرئيسية التي يمكنك إجراؤها:
- إدارة مجموعة البيانات: تفاعل مع مجموعات البيانات باستخدام
dataset
والتي تُرجع methodDatasets
كائن. تستطيع الحصول على, إنشاء, تحديث, حذف, قائمة, الحصول على عنوان URL للوصول إلى مجموعة البيانات، و تحميل مجموعات البيانات. - قائمة مجموعة البيانات: احصل على قائمة بمجموعات البيانات باستخدام
dataset_list
والتي تُرجع methodDatasetList
كائن. - إدارة المشاريع: قم بإدارة مشاريعك عن طريق جلبها أو إنشائها أو تحديثها أو حذفها.
تهانينا على إعداد Ultralytics HUB-SDK! أنت الآن مجهز تجهيزًا جيدًا للشروع في رحلتك نحو دمج خدمات تعلم الآلة المتطورة في تطبيقاتك. استكشف وثائقنا الإضافية للحصول على إرشادات حول استخدام واجهات برمجة التطبيقات (APIs) المحددة، وراجع منتديات المجتمع الخاصة بنا إذا واجهت أي عقبات. ترميز سعيد، ونتمنى أن تزدهر مشاريعك بقوة Ultralytics! 🌟