عن المشروع

huggingface_hub هي واجهة سطر الأوامر الرسمية وعميل Python لمنصة Hugging Face Hub، وهي منصة لمشاركة نماذج التعلم الآلي مفتوحة المصدر ومجموعات البيانات والعروض التوضيحية. يوفر المشروع الواجهتين في حزمة واحدة: واجهة `hf` لسطر الأوامر ومكتبة `huggingface_hub` بلغة Python. يتوفر التثبيت عبر نص تثبيت مستقل لنظم macOS وLinux وWindows، أو عبر pip/uv لحزمة Python، التي تثبّت واجهة سطر الأوامر أيضاً. تحافظ مجموعات التبعيات الاختيارية (مثل وحدة MCP) على الحد الأدنى من التثبيت الافتراضي. القدرات الأساسية الموضحة في README: - تنزيل ملفات فردية أو مستودعات كاملة، مع تخزين الملفات في مجلد ذاكرة تخزين مؤقت محلي. - رفع ملفات فردية أو مجلدات كاملة إلى مستودعات النماذج أو مجموعات البيانات أو Spaces. - إنشاء المستودعات وإدارتها على Hub. - تشغيل الاستدلال على النماذج المنشورة. - تشغيل Jobs على بنية Hugging Face التحتية. - البحث عن النماذج ومجموعات البيانات وSpaces. - مشاركة بطاقات النماذج لتوثيق النماذج. - التفاعل مع المجتمع عبر طلبات السحب والتعليقات. صُممت واجهة سطر الأوامر صراحةً للبشر ووكلاء البرمجة على حد سواء: يتكيف مخرجات الأوامر عند استدعائها بواسطة وكيل، ويمكن تثبيت مرجع مهارة مُولَّد لأدوات مثل Claude Code وCodex وCursor وOpenCode. تستخدم المصادقة رموز Hub، مع خيار رمز غير تفاعلي للبيئات الآلية. يشير README أيضاً إلى التكاملات مع مكتبات التعلم الآلي مفتوحة المصدر الأخرى، مما يوفر استضافة مجانية للنماذج ومجموعات البيانات، وإصدار الملفات للملفات الكبيرة عبر خلفية التخزين Xet، وعناصر واجهة داخل المتصفح، وتنزيلات معجّلة عبر CDN، وإحصاءات الاستخدام. كما تُقدَّم إرشادات المساهمة لطلبات الميزات وتقارير الأخطاء.