دوز مباشرة للمحتوى الرئيسي
دروس فالذكاء الاصطناعي

ثبّت واستعمل الإضافات الرسمية مع Hermes Agent

تعلّم كيفاش تثبّت Hermes Agent، وتستكشف الكاتالوغ ديال الإضافات المراجَعة، وتزيد الإضافات الرسمية وتحدّثها، وتنقل التثبيتات القديمة، وتجرّب الإضافات محلياً. هاد الدليل كيقدّم حتى التكاملات الرسمية المتوفّرة وكيشرح كيفاش كتوفر تثبيتات الكاتالوغ إصدارات مضبوطة.

حوالي 20 دقايق ديال القراية
ثبّت واستعمل الإضافات الرسمية مع Hermes Agent
إضافات Hermes الرسمية

شنو كيوفرو Hermes Official Plugins

Hermes Official Plugins هي المجموعة الرسمية ديال الإضافات لـ Hermes Agent، وكتصاوبها Nous Research. كل مجلد فالمستودع فيه تكامل مستقل بذاتو، ويمكن تثبيتو من خلال كتالوج إضافات Hermes.

Hermes Agent هو وكيل ذكاء اصطناعي كيطوّر راسو، كيقدر يحتافظ بالمعلومات المفيدة بين الجلسات، يطوّر المهارات بالتجربة، ويخدم عبر واجهات بحال الطرفية، وHermes Desktop، وTelegram، وDiscord، وSlack، وWhatsApp، وSignal. وكيدعم مصادر متعددة للنماذج، منها Nous Portal وOpenRouter وAnthropic وOpenAI ونقاط النهاية المخصصة.

المشروع كيخلي الأجزاء العامة ديال Hermes فالنواة، بحال حلقة الوكيل، والذاكرة، والمهارات، والبوابة، وتوجيه النماذج، وبيئة تشغيل الأدوات. أما القدرات الخاصة بالمنتوج أو بالمزوّد فكتبقى فإضافات مستقلة.

علاش Hermes كيستعمل الإضافات

  • تثبيتات أصغر: كتثبت غير التكاملات اللي محتاج.
  • إصلاحات مستقلة: الإضافة تقدر تستقبل تحديث مراجع عليه بلا ما تستنى إصدار جديد من نواة Hermes.
  • مسؤولية واضحة: Nous كتحافظ على الإضافات الرسمية، بينما المزوّدين والكتّاب المستقلين كيسيرو إضافات المجتمع.
  • إصدارات مراجع عليها: إدخالات الكتالوج مثبتة على commits مراجع عليها، وبهذا التثبيت والتحديثات كيستعملو نسخ معروفة.
  • تنزيلات فعالة: Hermes كيجلب غير مجلد الإضافة المختارة باستعمال استنساخ sparse بلا blobs.

المتطلبات الأساسية وتثبيت Hermes

خاصك تثبيت خدام ديال Hermes Agent قبل ما تزيد هاد الإضافات. فالنظام المدعوم، شغّل سكريبت التثبيت اللي مبين فـ README ديال Hermes:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

من بعد التثبيت، تأكد باللي واجهة سطر الأوامر متاحة:

hermes --help

بعض الإضافات عندها متطلبات زايدة. مثلا، Spotify كيتطلب تطبيق المطوّر ديالك فـ Spotify باش تسجّل الدخول، وBlender كيتطلب Blender 5.1 أو أحدث مع إضافة MCP ديالو، وSnyk كيتطلب Node.js وnpm وحساب Snyk. راجع معلومات الإضافة فـ الكتالوج قبل ما تثبتها.

استكشف كتالوج الإضافات

كتالوج إضافات Hermes فيه تكاملات رسمية وتكاملات ديال المجتمع مراجع عليها. استعمل أمر البحث باش تتصفح الإدخالات المتاحة:

hermes plugins search

شوف تفاصيل إضافة معينة قبل التثبيت:

hermes plugins info spotify

إدخال المعلومات كيشرح شنو كتدير الإضافة، والمتطلبات ديالها، والـ commit المراجع عليه اللي مثبتة عليه. مستعملو Hermes Desktop يقدرو يوصلو لنفس الكتالوج من Capabilities → Plugins.

ثبّت إضافة وحدّثها

  1. قلب على التكامل اللي بغيتي:

    hermes plugins search

  2. قرا المتطلبات والبيانات الوصفية ديالو:

    hermes plugins info spotify

  3. ثبّت النسخة المراجع عليها:

    hermes plugins install spotify

  4. ملي كتولي نسخة أحدث ومراجع عليها متاحة، حدّث الإضافة:

    hermes plugins update spotify

التحديث كيتبع الكتالوج حتى للـ commit المراجع عليه اللي من بعد. ما كيثبتش تلقائيا نسخة عشوائية من المستودع.

اختار إضافة رسمية

Home Assistant

إضافة Home Assistant كتزيد منصة بوابة وأربع أدوات لعرض الكيانات، وقراية الحالات، وعرض الخدمات، واستدعاء الخدمات. Hermes يقدر يراقب ناقل الأحداث، ويتفاعل مع تغييرات محددة فالحالة، ويتحكم فالأجهزة عبر REST API، ويرد من خلال إشعارات Home Assistant.

hermes plugins install homeassistant

الأدوات ديالها هي ha_list_entities وha_get_state وha_list_services وha_call_service. مهام Cron تقدر تستهدف Home Assistant باستعمال deliver=homeassistant.

Spotify

إضافة Spotify كتوفّر أدوات للتحكم فالتشغيل، وأجهزة Spotify Connect، وقائمة الانتظار، والبحث، وقوائم التشغيل، والألبومات، والمكتبة ديال المستخدم.

hermes plugins install spotify
hermes spotify login

أمر تسجيل الدخول كيدير تسجيل دخول PKCE محلي باستعمال تطبيق المطوّر ديالك فـ Spotify. خاص اشتراك Spotify Premium باش تتحكم فالتشغيل.

Claude Subscription DirectSDK

موفّر النماذج التجريبي هادا كيشغّل دورات Hermes عبر CLI الرسمي ديال Claude Code باستعمال اشتراك Claude Pro أو Max. Hermes كيبقى محتافظ بحلقة الوكيل ديالو، والأدوات، ومعالجة الموافقات، والضغط، بينما الإضافة كتستعمل الملف التنفيذي الموثّق claude كعميل نموذج خاص بكل طلب.

hermes plugins install claude-subscription-directsdk

من بعد التثبيت، حلّ hermes model واختار Claude Subscription DirectSDK (Experimental). إلا ما كانش Claude Code متاح، الإضافة كترفض الخدمة وكتعطي تلميح باش تثبتو.

وضعية Telegram Business

وضعية Telegram Business كتحوّل Hermes لمساعد كيراقب وكيستنى الموافقة فحساب Telegram Business. يقدر يوجّد ردود للزبناء، ولكن كل رد خاصو موافقة المالك قبل ما يتصيفط.

hermes plugins install hermes-telegram-business

ويكي ديال الذاكرة

ويكي ديال الذاكرة كيزيد لوحة تحكم وتبويبة فـ Hermes Desktop كتنظّم السجل المحلي ديال الجلسات فصفحات حسب المواضيع وسجلات يومية. وكيقدّم حتى لوحة تدقيق للقراءة فقط ديال MEMORY.md وUSER.md. الإضافة كتقرا السجل المحلي وما كتكتبش فيه.

hermes plugins install hermes-memory-wiki

Blender

إضافة Blender كتجمع بين خادم MCP الرسمي ديال Blender Lab ومهارة سير العمل ديال Blender. كتحتاج Blender 5.1 ولا أحدث مع إضافة MCP ديالو، وزيد عليهم Git وuv. كتدعم Windows وmacOS وLinux.

hermes plugins install blender

أدوات Blender كتشغّل Python داخل Blender. استعمل غير سيريات عمل موثوقة وراجع العمليات اللي تقدر تبدّل المشهد ديالك.

Snyk

إضافة Snyk كتستعمل خادم MCP الرسمي ديال Snyk وكتضم مهارة سير العمل snyk-security-scan. تقدر تفحص الكود المصدري، والاعتماديات، وصور الحاويات، وإعدادات البنية التحتية ككود، ولوائح مكوّنات البرمجيات.

hermes plugins install snyk

كتحتاج Node.js وnpm وحساب Snyk. المصادقة كتدار عبر المتصفح باستعمال snyk_auth.

TouchDesigner

إضافة TouchDesigner كتربط بجلسة TouchDesigner خدامة عبر خادم MCP المجاني twozero ديال 404.zero، واللي كيتشغّل داخل TouchDesigner. كتضم مهارة لسير العمل وأكثر من 20 ملف مرجعي كيغطي مواضيع بحال operators وGLSL والمشاريع المتفاعلة مع الصوت وinstancing.

hermes plugins install touchdesigner

دعم TouchDesigner متوفر فـ macOS وWindows.

Accent Picker

Accent Picker هي إضافة لـ Hermes Desktop كتزيد عجلة ألوان OKLCH فشريط الحالة. جرّ العجلة كيبدّل لون السمة فالحين، وكيخلّي مؤلفي السمات يجرّبو ألوان التمييز مباشرة فبلاصتها. اللون المختار حالة مؤقتة للتجربة وما كيتحفظش.

hermes plugins install accent-picker

ترحيل تثبيت قديم

بعض الإضافات الرسمية كانت من قبل جزء من Hermes core ولا كانت فمستودعات منفصلة. الترحيل المطلوب كيعتمد على الطريقة اللي ثبّتها بها أول مرة.

  • Home Assistant ولا Spotify المدمجين: شغّل hermes update. أول تشغيل من بعد التحديث يقدر يثبّت إضافة الكتالوج مع الحفاظ على الإعدادات الموجودة ومتغيرات البيئة وتسجيل الدخول.
  • التثبيت من الكتالوج: شغّل hermes plugins update <name>. الكتالوج دابا كيشير للمستودع الرسمي ديال الإضافات وكيحافظ على الملفات ديالك أثناء النقل.
  • التثبيت باستعمال URL: عاود التثبيت مرة وحدة من الكتالوج باستعمال hermes plugins install <name> --force. هاد الشي ضروري حيث المستودعات القديمة المستقلة ولات مؤرشفة وما بقاتش كتوصلها الإصلاحات.

فهم بنية المستودع

كل مجلد ديال إضافة فالمستوى الأعلى هو حزمة كاملة. إضافات Python غالباً كتضم manifest وكود التسجيل والاعتماديات والاختبارات. الإضافات المحمولة المبنية على MCP تقدر تستعمل plugin.json وmcp.json ومجلد المهارات، بينما إضافات Desktop تقدر تضم JavaScript داخل مجلد desktop.

hermes-official-plugins/
├── assets/
├── homeassistant/
│   ├── plugin.yaml
│   ├── __init__.py
│   ├── pyproject.toml
│   └── tests/
├── blender/
├── accent-picker/
└── ...

الكتالوج كيحدّد الإضافة باستعمال المستودع والمجلد الفرعي وcommit مثبت. وبالتالي، تثبيت Spotify ما كيحمّلش إضافة Home Assistant.

اختبار إضافة محلياً

للتطوير، كلون Hermes Agent والمستودع الرسمي ديال الإضافات حدّ حدّ:

git clone https://github.com/NousResearch/hermes-agent
git clone https://github.com/NousResearch/hermes-official-plugins
cd hermes-official-plugins/spotify
HERMES_AGENT_REPO=../../hermes-agent PYTHONPATH=../../hermes-agent python -m pytest -q

الإضافات الرسمية كتتختبر مع Hermes core الحالي على Linux وmacOS وWindows مع كل push وpull request. وكيتستعمل حتى الاختبار الليلي باش يكتاشف تغييرات core اللي كتخرب الإضافات.

باش تثبّت نسخة محلية فبيئة Hermes خدامة، مرّر مسار المجلد وفرض الاستبدال:

hermes plugins install ./spotify --force

نصائح متقدمة

  • عاين قبل التثبيت: استعمل hermes plugins info <name> باش تشيك على التبعيات والكوميت اللي تراجع.
  • فضّل السميات ديال الكاتالوغ: التثبيت من الكاتالوغ كيتبع الإصدارات المثبتة والمراجَعة الجاية بشكل أنظف من التثبيت المباشر بالرابط.
  • استعمل القوة بحذر: الخيار --force مفيد فالترحيل والاختبار المحلي، ولكن تأكد بلي كتبدل التثبيت المقصود.
  • احترم حدود الموافقة: إضافات بحال Telegram Business Mode كتطلب الموافقة عمداً قبل ما تصيفط الردود.
  • راجع التكاملات القوية: الأدوات اللي كتنفذ الكود داخل التطبيقات، بحال Blender، خاصها تستعمل غير مع سيرورات عمل موثوقة.
  • بلّغ على المشاكل فالمستودع المناسب: حلّ المشاكل الخاصة بالإضافة فالمستودع الرسمي ديال الإضافات، وضمّن سميّة الإضافة فالعنوان، بحال [spotify] .... بلّغ على مشاكل النواة فـ متتبع مشاكل Hermes Agent.

إصدار وبناء الإضافات

بالنسبة للمحافظين، دمج تغيير ديال إضافة ففرع main ديال المستودع ما كيحدّثش بوحدو المستخدمين ديال الكاتالوغ. كيكمل الإصدار بفتح طلب دمج ضد Hermes Agent وتبديل القيمة ديال sha: ديال الإضافة فـ plugin-catalog/<name>.yaml. التثبيت ديال الكاتالوغ كيمثل نسخة الإصدار.

باش تصايب التكامل ديالك، بدا بـ دليل إضافات Hermes والإضافات النموذجية. الإضافات العادية عبارة على حزم Python بسيطة ومعاها بيان plugin.yaml. الإضافات اللي سالاو يمكن تقديمها لكاتالوغ Hermes باش تتراجع.

الخلاصة

Hermes Official Plugins كيوفر طريقة مضبوطة باش توسّع Hermes Agent بلا ما تحط كل تكامل فالنواة. قلب فلكاتالوغ، عاين المتطلبات ديال الإضافة، ثبّت النسخة المراجَعة، واستعمل أمر التحديث باش تنتاقل لمراجعات لاحقة تراجعات. والمطورين يقدرو حتى ينسخو المستودع، يشغلو الاختبارات الخاصة بالإضافة، ويثبتو المجلدات المحلية باش يديرو اختبارات واقعية.