تثبيت Hermes وتهيئة OmniProxy

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

قبل البدء

أولاً، اختر طريقة التثبيت بناءً على نظام تشغيل حاسوبك. يمكن لمستخدمي macOS وWindows استخدام برامج التثبيت الرسومية مباشرة، بينما يمكن لمستخدمي Linux وmacOS وWSL2 استخدام سكربت طرفي. WSL2 هي ميزة في Windows لتشغيل بيئة Linux. تمتلك 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 على قرص خارجي، فقم بتوصيل القرص أولاً وتأكد من وجود مساحة كافية عليه.

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

إذا كنت تريد تطبيقاً رسومياً

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

• macOS: افتح ملف DMG وانقل Hermes.app إلى مجلد التطبيقات (Applications). ملف DMG هو صورة تثبيت شائعة الاستخدام على macOS. يدعم برنامج التثبيت هذا معالجات Apple silicon فقط؛ أما أجهزة Mac بمعالجات Intel فهي غير مدعومة.
• Windows: افتح ملف .appinstaller باستخدام Windows App Installer. يقوم بتثبيت حزمة 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. قم بتهيئة عناوين URL لخدمة Grok وGemini في OmniProxy؛ لا تدخلها مباشرة في Hermes.

حاسوبك

Hermes

→

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

OmniProxy

• أدرج /v1 في العنوان

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

معرف النموذج (Model ID) هو الاسم الدقيق الذي تستخدمه واجهة برمجة التطبيقات (API) لتحديد النموذج. استخدم الأسماء التالية للنموذجين:

• بالنسبة لـ 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 كنقطة نهاية للـ API.

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

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

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

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

إدخال تهيئة الأدوات

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

hermes model

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

يطلب معالج الإعداد عنوان URL لنقطة النهاية، والمفتاح، واسم النموذج بالتسلسل. أدخل القيم الثلاث من القسم السابق. لاستخدام 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.

رؤية أن معالج الإعداد تم حفظه بنجاح، أو أن الـ API أعاد استجابة ناجحة، لا يكفي لإثبات أن 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 يعمل وتحقق من أن عنوان 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 ودعم المنصات. لتهيئة نقطة النهاية المخصصة، راجع وثائق مزود Hermes. لمعرفات النماذج، راجع وثائق نموذج 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 وحدها لا تثبت توافق الوكيل الكامل. تحقق من المصدر والنموذج في سجل طلبات OmniProxy.

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