واجهة Hugging Face CLI لوكلاء الذكاء الاصطناعي

يُعدّ سطر الأوامر hf طريقة رائعة لربط وكلاءك بـ Hugging Face Hub والنظام البيئي المحيط به. ابحث عن النماذج، وأدر مجموعات البيانات والخزانات، وأطلق Spaces، ونفّذ المهام من أي وكيل برمجي.

هذا دليل سريع حول الوكلاء الذين يستخدمون واجهة سطر الأوامر. لمزيد من المعلومات التفصيلية، راجع مرجع واجهة سطر الأوامر نفسه.

تثبيت واجهة سطر الأوامر

تأكد من تثبيت hf CLI وتحديثه إلى أحدث إصدار. راجع دليل تثبيت CLI للحصول على تعليمات الإعداد.

يقوم المثبّت المستقل الموصى به أيضاً بتثبيت مهارة CLI على مستوى النظام، بما في ذلك موقع Claude Code، بحيث يلتقطها الوكلاء دون أي خطوة إضافية. مرّر --exclude-skill (أو -ExcludeSkill على Windows) لتخطيها.

أضف مهارة سطر الأوامل

توفّر المهارات (Skills) لوكيلك السياق الذي يحتاجه لاستخدام الأدوات بفعالية. يضيف المثبّت المستقل مهارة سطر الأوامر (CLI Skill) نيابةً عنك — ثبّتها يدويًا إذا كنت قد استخدمت pip أو Homebrew، أو تجاوزتها، أو ترغب في تضمينها في مشروع واحد. تعرّف على المزيد حول المهارات (Skills) في agentskills.io.

# install globally (available in all projects, works with Claude Code, Codex, Cursor,
# OpenCode, and any agent that loads skills from ~/.agents/skills)
hf skills add --global

# or install for the current project only
hf skills add

يتم توليد المهارة من نسخة CLI المثبتة محليًا لديك، لذا تصبح قديمة عند ترقية البرنامج. hf update يحدّث المهارة المثبتة على مستوى النظام — دون إعادة إضافة أي مهارة قمت بإزالتها — بينما hf skills update -g يحدّثها بشكل مستقل. كما ينبّهك hf مرة واحدة يوميًا إذا كانت المهارة مفقودة أو قديمة؛ ويمكنك كتم هذا التنبيه باستخدام HF_HUB_DISABLE_UPDATE_CHECK=1.

بديلًا عن ذلك، يمكنك التثبيت عبر نظام إضافات Claude Code:

claude
/plugin marketplace add huggingface/skills
/plugin install hf-cli@huggingface-skills

الموارد

• مرجع سطر الأوامر - توثيق كامل للأوامر
• إعدادات الرموز - إدارة رموزك
• توثيق المهام - دليل مهام الحوسبة