تثبيت Hermes وإعداده مع OmniProxy

Hermes هو مساعد يستطيع الاحتفاظ بسجل المحادثات وخبرات المهام، كما يمكنه تنظيم الأعمال السابقة في صورة مهارات قابلة لإعادة الاستخدام لاحقًا. ويمكنه أيضًا الاتصال عبر Gateway واحد بكل من Telegram وDiscord وSlack وWhatsApp وSignal والطرفية؛ ويمكن فهم Gateway على أنه نقطة دخول موحّدة لاستقبال الرسائل وإعادة توجيهها. يمكنك تكليفه من أداة الدردشة المعتادة بمراجعة الشيفرة أو تسجيل الحوادث أو معالجة مواد العملاء، ثم جعله يعود إلى المستودع لمتابعة العمل.

التحضير قبل التثبيت

اختر أولًا طريقة التثبيت وفقًا لنظام تشغيل جهازك. يمكن في macOS وWindows استخدام حزمة تثبيت ذات واجهة رسومية مباشرةً، بينما يمكن في Linux وmacOS وWSL2 استخدام برنامج الطرفية النصي. تتيح WSL2 تشغيل بيئة Linux داخل Windows. تتوفر أيضًا طرق تثبيت خاصة لكل من Termux على هواتف Android وDocker، لكن هذا الدليل يشرح التثبيت على أجهزة الكمبيوتر العادية فقط.

إذا أردت نافذة

macOS وWindows

• macOS: افتح DMG
• Windows: افتح حزمة التثبيت
• ضع التطبيق في النظام

إذا أردت الطرفية فقط

Linux وmacOS وWSL2

• أمر install.sh واحد
• استخدم install.ps1 على Windows
• اكتب hermes بعد اكتمال التثبيت

لا تستخدمها الآن

pip وbrew وAUR

• طرق التثبيت هذه غير مدعومة رسميًا
• يصعب تحديثها حتى بعد تثبيتها
• استخدم إحدى الطريقتين على اليسار بدلًا منها

قبل البدء، جهّز جهاز كمبيوتر يعمل بنظام macOS أو Windows أو Linux، وتأكد من إمكانية فتح الطرفية والوصول إلى GitHub. إذا كنت تخطط للتثبيت على قرص خارجي، فصِل القرص أولًا وتأكد من توفر مساحة كافية عليه.

التثبيت والتشغيل للمرة الأولى

إذا كنت تريد واجهة رسومية

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

• macOS: افتح ملف DMG، ثم انقل Hermes.app إلى «التطبيقات». ملف DMG هو ملف صورة تثبيت شائع الاستخدام في macOS. تدعم هذه الحزمة أجهزة Apple silicon فقط، ولا تشمل أجهزة Intel Mac.
• Windows: افتح ملف .appinstaller باستخدام مثبّت التطبيقات في Windows. سيؤدي ذلك إلى تثبيت حزمة MSIX موقّعة، وهي أحد أنواع حزم تثبيت التطبيقات التي يستخدمها Windows.
• Linux: حزمة سطح المكتب مخصصة لنظامي macOS وWindows. في Linux، استخدم أمر الطرفية الموضح أدناه، وبعد اكتمال التثبيت يمكنك تشغيل hermes desktop.

إذا كنت تريد الطرفية فقط

إذا كنت تستخدم Linux أو macOS أو WSL2، فنفّذ الأمر التالي في الطرفية:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

عند استخدام PowerShell المضمّن في Windows، نفّذ:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

سينزّل المثبّت شيفرة Hermes والبرامج اللازمة لتشغيله. إذا انقطع التنزيل أثناء العملية، فأعد تنفيذ الأمر نفسه. بعد اكتمال التثبيت، أغلق نافذة الطرفية الحالية أولًا، ثم افتح نافذة جديدة وأدخل:

hermes

إذا ظهر موجّه Hermes، فهذا يعني أن الأمر أصبح متاحًا. بعد ذلك، يمكنك تشغيل hermes doctor؛ وهو فحص للتثبيت يوضح العناصر التي لا تزال ناقصة.

وضع البرنامج على قرص خارجي

في 9 أكتوبر 2026، ثُبّت Hermes Agent v0.21.6 على قرص خارجي في جهاز Mac. وُضع البرنامج في /Volumes/AItools/tools/hermes-agent، ووُضع أمر التشغيل في ~/.local/bin/hermes، بينما بقيت الإعدادات والمحادثات محفوظة في ~/.hermes.

إذا كان اسم القرص لديك مختلفًا، فغيّر المسار الذي يلي --dir إلى مجلدك. يجب أن يبقى هذا القرص متصلًا عند تشغيل Hermes.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh -o install.sh
bash install.sh --dir /Volumes/AItools/tools/hermes-agent --non-interactive

البرنامج

قرص صلب خارجي

• tools/hermes-agent
• ضع الشيفرة هنا

الأمر

~/.local/bin/hermes

• اكتب hermes في الطرفية
• يصبح فعّالًا بعد فتح نافذة جديدة

الإعدادات والمحادثات

~/.hermes

• يوجد config.yaml هنا
• اخرج من التطبيق قبل فصل القرص

الحصول على معلمات الاتصال من OmniProxy

يتصل Hermes هنا بـ OmniProxy، ولا يتصل مباشرةً بـ Grok أو Gemini. تُضبط عناوين خدمتي Grok وGemini داخل OmniProxy، لذلك لا تدخلها مباشرةً في Hermes.

جهازك

Hermes

→

البوابة المحلية

OmniProxy

• اجعل العنوان ينتهي بـ /v1

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

معرّف النموذج هو الاسم الدقيق الذي تستخدمه الواجهة للتعرف على النموذج. استخدم الاسمين التاليين للنموذجين:

• بالنسبة إلى Grok، أدخل grok-4.7. واجهة xAI هي https://api.x.ai/v1، وتستخدم طلبات الدردشة المسار /v1/chat/completions. راجع وثائق نماذج Grok.
• بالنسبة إلى Gemini، أدخل gemini-3.8-flash. واجهة Google المتوافقة مع OpenAI هي https://generativelanguage.googleapis.com/v1beta/openai/. راجع شرح توافق Gemini مع OpenAI.

إذا أردت التبديل إلى Gemini في Hermes، فما عليك سوى تغيير اسم النموذج إلى gemini-3.8-flash، مع إبقاء عنوان الواجهة على عنوان OmniProxy.

انسخ عنوان الواجهة والمفتاح من OmniProxy، ثم أدخل معرّف النموذج المناسب:

Base URL: https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: grok-4.7

Base URL هو عنوان الواجهة الذي يرسل Hermes الطلبات إليه، ويجب أن ينتهي هنا بـ /v1. أما API Key فهو المفتاح الذي يصدره OmniProxy إلى Hermes؛ استبدله بقيمتك الخاصة ولا تنشره في صفحة عامة.

إذا كان OmniProxy المحلي لا يطلب مفتاحًا، فيمكن ترك API Key فارغًا؛ أما إذا كان العنوان متاحًا لأشخاص آخرين، فيجب إدخال مفتاح. تأكد أيضًا من إمكانية الوصول إلى هذا العنوان من البيئة التي يعمل فيها Hermes. عندما يعمل Hermes وOmniProxy على الجهاز نفسه، يمكنك استخدام عنوان محلي.

إدخال إعدادات الأداة

اخرج أولًا من المحادثة الجارية، ثم نفّذ في الطرفية:

hermes model

اختر Custom endpoint (self-hosted / VLLM / etc.). يعني Custom endpoint استخدام واجهة مخصصة، أي جعل Hermes يتصل بعنوان الخدمة الذي تحدده بدلًا من استخدام مزوّد مُعد مسبقًا.

سيطلب منك المعالج عنوان الواجهة والمفتاح واسم النموذج بالترتيب. أدخل القيم الثلاث الواردة في القسم السابق. لاستخدام Gemini، أدخل gemini-3.8-flash بوصفه اسم النموذج.

يمكنك أيضًا تعديل ~/.hermes/config.yaml مباشرةً. YAML هو تنسيق نصي يستخدم المسافات البادئة للتعبير عن العلاقات بين الإعدادات. فيما يلي إعداد Grok:

model:
  default: grok-4.7
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

عند استخدام Gemini، غيّر قيمة default إلى gemini-3.8-flash، واترك العناصر الثلاثة الأخرى من دون تغيير:

model:
  default: gemini-3.8-flash
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

بعد الحفظ، شغّل hermes مجددًا ثم ابدأ المحادثة. داخل جلسة مفتوحة بالفعل، لا يستطيع الأمر /model سوى التبديل بين المزوّدين المحفوظين مسبقًا، ولا يمكن استخدامه لإضافة هذا الإعداد.

التحقق باستخدام مهمة فعلية

1

hermes doctor

• نجح فحص التثبيت

2

أرسل عبارة قصيرة

• تحقق من ظهور رد Hermes

3

افتح سجل الاستدعاءات

• تحقق من اسم النموذج

1. شغّل hermes doctor للتحقق من اكتمال التثبيت.
2. شغّل hermes، واطلب منه أن يشرح في جملة واحدة ما يمكنه فعله. يُفترض أن ترى ردًا.
3. افتح سجل الاستدعاءات في OmniProxy، وتأكد من أن الطلب صادر من Hermes، ثم تحقق مما إذا كان اسم النموذج هو grok-4.7 أو gemini-3.8-flash.

لا يكفي ظهور رسالة تفيد بأن المعالج حفظ الإعداد بنجاح أو أن الواجهة أعادت استجابة ناجحة لإثبات أن Hermes أصبح قادرًا على تنفيذ المهام نيابةً عنك. يجب أن يطابق اسم النموذج في سجل الاستدعاءات القيمة التي أدخلتها.

إذا أردت الدردشة من المتصفح، فنفّذ محليًا:

hermes dashboard --no-open --host 127.0.0.1 --port 9119

ثم افتح http://127.0.0.1:9119. لا يعمل هذا العنوان إلا على جهاز الكمبيوتر الحالي.

الأخطاء الشائعة

• تظهر رسالة تفيد بعدم العثور على الأمر عند إدخال hermes: أغلق الطرفية أولًا، ثم افتح نافذة جديدة. إذا استمرت المشكلة، فتأكد من إضافة ~/.local/bin إلى PATH؛ وPATH هي قائمة بالمواقع التي يبحث فيها النظام عن مجلدات الأوامر. في Windows، تأكد من أن مجلد التشغيل الذي أضافه المثبّت موجود في PATH.
• ينقطع تنزيل التثبيت في منتصف العملية: أعد تنفيذ أمر التثبيت نفسه، وستُستخدم الأجزاء التي نُزّلت بالفعل.
• لا يرد Hermes أو تظهر رسالة تفيد بتعذر الاتصال: تأكد من أن OmniProxy يعمل، وتحقق من أن Base URL ينتهي بـ /v1. إذا كان Hermes يعمل داخل Docker بينما يعمل OmniProxy على الجهاز المضيف، فلا تستخدم 127.0.0.1 الذي لا يكون صالحًا إلا من داخل الحاوية.
• تظهر رسالة تفيد بأن المفتاح غير صحيح: حدّث مفتاح OmniProxy، ثم عدّل api_key في config.yaml. مفاتيح xAI أو Google جزء من إعدادات مزوّدي OmniProxy، ولا تدخلها في هذا الحقل داخل Hermes.
• تظهر رسالة تفيد بعدم وجود النموذج: افتح قائمة النماذج الحالية في OmniProxy، وانسخ grok-4.7 أو gemini-3.8-flash حرفيًا كما يظهر في القائمة.
• يرد Hermes، لكنه لا يستطيع تنفيذ مهام مثل قراءة الملفات أو تشغيل الأوامر: اختر نموذجًا آخر في OmniProxy يدعم هذه القدرات، ثم افتح جلسة Hermes جديدة.
• وُضع البرنامج على قرص خارجي، وبعد فصل القرص يعرض hermes doctor خطأ في التخزين: أعد توصيل القرص أولًا. لا تجعل Hermes يكتب مجموعة إعدادات أخرى عندما يكون القرص غير متصل.

المراجع الرسمية

راجع خطوات التثبيت في وثائق تثبيت Hermes ودعم المنصات. راجع إعداد Custom endpoint في وثائق Hermes Provider. وللاطلاع على معرّفات النماذج، راجع وثائق نماذج Grok وشرح توافق Gemini مع OpenAI.

اكتملت تجربة التثبيت على macOS في 2026-10-09 باستخدام Hermes Agent v0.21.6. وكان grok-4.7 وgemini-3.8-flash معرّفي النموذج القياسيين الواردين في وثائق xAI وGoogle في ذلك اليوم. عند إدخال القيم فعليًا، اعتمد الاسم المعروض داخل OmniProxy.

استبدل كل عنصر نائب بقيم إعداد OmniProxy الخاصة بك. لا تنشر مفتاحاً حقيقياً أبداً.

لا يثبت الحفظ الناجح أو HTTP 200 وحده توافق Agent الكامل. تحقق من المصدر والنموذج في سجل استدعاءات OmniProxy.

المصادر الرسمية · Hermes ↗