EN
🤖 وكلاء AI

إعداد Hermes Desktop: دليل التثبيت لويندوز وماك ولينكس

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

مبتدئ10 دقيقة قراءة

وش راح تقدر تسوي بعد هذا الشرح

  • تثبّت Hermes Desktop (أو الطرفية) على جهازك بدقائق
  • تربط مزود نموذج — اشتراك أو مفتاح API
  • تشغّل أول محادثة تثبت إن كل شي يشتغل
  • تحل أشهر مشاكل التثبيت بنفسك

قبل ما تبدأ

  • جهاز عليه ويندوز أو ماك أو لينكس مع اتصال إنترنت
  • Git مثبّت (المتطلب الحقيقي الوحيد — تأكد بأمر git --version)
  • طريقة لاستخدام نموذج ذكاء اصطناعي: تسجيل دخول باشتراك (مثل Nous Portal) أو مفتاح API من أي مزود كبير

أغلب شروح التثبيت تفترض زيادة أو تعد بخدمات. هذا الدليل هدفه واحد: Hermes Agent شغال على جهازك، مثبوت بمحادثة حقيقية — مع حلول القلة من الأشياء اللي تخلط عادة.

وش بتثبّت بالضبط

تطبيقان، ونفس المخ:

  • Hermes Desktop — التطبيق الأصلي لويندوز وماك ولينكس: محادثة مباشرة، قائمة جلسات، سحب وإفلات للملفات، إشعارات.
  • Hermes CLI — نفس الوكيل بطرفيتك، بأوامر مثل hermes وhermes model وhermes doctor.

المثبّت الموصى به يعطيك الاثنين. وتحت الغطاء يجهز بايثون ونود وripgrep وffmpeg — بس أنت ما تديرها مباشرة أبدًا.

المتطلبات، بصدق

المتطلب الحقيقي الوحيد هو Git (git --version للتأكد). كل شي ثاني المثبّت يتكفل فيه. على لينكس أضف curl وxz-utils (موجودين بأغلب الأنظمة) وbuild-essential إذا تبي تطبيق سطح المكتب. وتحتاج طريقة واحدة للوصول لنموذج ذكاء اصطناعي: تسجيل باشتراك مثل Nous Portal، أو مفتاح API من OpenRouter أو Anthropic أو OpenAI أو جوجل وعشرات غيرهم — وأي نموذج تختاره لازم يدعم ٦٤ ألف توكن سياق على الأقل (كل النماذج السحابية تقريبًا تدعم).

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

الخطوات بالترتيب

١. ثبّت. حمّل مثبّت Hermes Desktop وشغّله — أو طرفية فقط بالأوامر الموجودة بقسم الخطوات فوق.

٢. أعد تحميل الطرفية عشان أمر hermes الجديد يبان.

٣. اربط نموذجًا. نفّذ:

hermes model

واختر مزودًا. أسرع طريق للمبتدئين:

hermes setup --portal

دخول OAuth واحد ← أكثر من ٣٠٠ نموذج + بحث إنترنت مدمج وتوليد صور ونطق. بدون أي إدارة مفاتيح.

٤. الاختبار الأول. نفّذ hermes واعطه مهمة قابلة للتحقق:

افحص المجلد الحالي وقلي أي ملف يبان إنه ملف التشغيل الرئيسي.

النجاح يبان كذا: الشريط يعرض نموذجك، الوكيل يرد بدون أخطاء، يقرأ ملفًا حقيقيًا، والمحادثة تكمل أكثر من دورة. هذي كلها القائمة.

٥. تحقق من الحفظ. اخرج، بعدها نفّذ hermes --continue. آخر جلسة المفروض ترجع سليمة. الجلسات اللي تعيش بعد الإغلاق هي اللي تخلي المشاريع الطويلة ممكنة.

لما شي ينكسر

قبل البحث بالمنتديات، اسأل دكتور الوكيل نفسه:

hermes doctor

يسمّي القطعة الناقصة بدقة. والثلاثة الكلاسيكيين، بحلولهم:

العرض الحل
hermes: command not found أعد تحميل الطرفية / صحّح PATH
API key not set hermes model — أكمل ضبط المزود
الإعدادات تبان غلط بعد تحديث hermes config check بعدها hermes config migrate

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

الخطوة الجاية

وكيلك يشتغل محليًا الحين. حطه بجيبك مع Hermes وتيليجرام، وتعلم قياده اليومي في Hermes للمبتدئين، أو ادخل مباشرة للأتمتة مع مهارات Hermes والنماذج والأتمتة.

ولسا تحزن بين الوكلاء والشات بوتات العادية؟ ما هو Hermes Agent؟ يحسمها بثماني دقايق.

الخطوات

  1. الخطوة 1: اختر طريق التثبيت

    طريقان مدعومان. **الأول (الموصى به للمبتدئين):** حمّل مثبّت Hermes Desktop من موقع hermes-agent.nousresearch.com وشغّله — يثبّت تطبيق سطح المكتب وأداة `hermes` للطرفية معًا. **الثاني (طرفية فقط):** نفّذ مثبّت الشل بطرفيتك. على لينكس وماك وWSL2: `curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash`. وعلى ويندوز الأصلي، بوويرشيل: `iex (irm https://hermes-agent.nousresearch.com/install.ps1)`.

    ملاحظة: بدأت بطرفية بس وغيّرت رأيك؟ نفّذ `hermes desktop` بعدها — يجهز ويطلع تطبيق سطح المكتب.

  2. الخطوة 2: خلّ المثبّت يسوي شغله

    المثبّت يتكفل بكل شي تلقائيًا: بايثون 3.11 وNode.js v22 عبر uv، وأداتي ripgrep وffmpeg، وتنزيل المستودع، والبيئة الافتراضية، وأمر `hermes` العالمي. ما تحتاج تثبت بايثون أو نود بنفسك — وهذي هي الفلسفة. لما يخلص، أعد تحميل طرفيتك (`source ~/.bashrc` أو سكّرها وافتحها).

    ملاحظة: على لينكس، تطبيق سطح المكتب يحتاج إضافة أدوات البناء: sudo apt install build-essential على دبيان/أوبونتو.

  3. الخطوة 3: اختر المزود والنموذج

    هذي أهم خطوة بكل الإعداد — هي اللي تحدد بعقل مين يفكر. نفّذ `hermes model` وامشِ مع المعالج. أسهل طريق: Nous Portal (`hermes setup --portal`) — تسجيل دخول واحد يغطي أكثر من ٣٠٠ نموذج مع أدوات مدمجة مثل بحث الإنترنت وتوليد الصور والنطق، بدون مفاتيح API تتخربط فيها. تفضّل الدفع حسب الاستخدام؟ OpenRouter يعطيك مفتاح واحد لكثير من النماذج؛ وAnthropic وOpenAI وجوجل لكل واحد مفتاحه؛ والنماذج المحلية تشتغل عبر Ollama أو llama.cpp.

    ملاحظة: شرط واحد صارم: النموذج لازم يدعم ٦٤ ألف توكن سياق على الأقل. تقريبًا كل النماذج السحابية تجتازها بسهولة؛ وإذا استضفت نموذجًا محليًا، ارفع قيمة السياق بالتبعية.

  4. الخطوة 4: افهم وين تسكن الإعدادات

    ملفان، وكل له وظيفة: الأسرار ومفاتيح API بمكانها `~/.hermes/.env`، والإعدادات العادية بـ`~/.hermes/config.yaml`. ونادرًا ما تلمس أيًّا منهما يدويًا — الأمر `hermes config set KEY VALUE` يكتب بالملف الصح تلقائيًا. هالفصل يخلي المفاتيح بعيدة عن أي شي ممكن تشاركه أو تزامنه.

    ملاحظة: `hermes setup` يعيد المعالج الكامل بأي وقت؛ و`hermes config get KEY` يعرض قيمة واحدة.

  5. الخطوة 5: أول اختبار ناجح

    اكتب `hermes` واضغط Enter. المفروض يطلع شريط الترحيب فيه النموذج اللي اخترته والأدوات المتاحة. أعطه مهمة تثبت وصوله للأدوات، مثل «افحص المجلد الحالي وقلي أي ملف يبان إنه ملف التشغيل الرئيسي». إذا جاوب وقادر يقرأ ملفات، خلصت — هذي كلها المعايير.

    ملاحظة: بعدها تحقق إن الجلسات تنحفظ: اخرج، نفّذ `hermes --continue`، وتأكد إن آخر محادثة رجعت سليمة.

  6. الخطوة 6: تحقق من الصحة إذا حسيت بشي غريب

    `hermes doctor` هو الفحص الرسمي: يخبرك بالضبط وش الناقص — مسارات PATH، مفاتيح، اعتماديات — وكيف تصلح كل بند. نفّذه قبل ما تدور بالمنتديات.

    ملاحظة: `hermes update` يحدّث التنصيب؛ وHermes يتعرّف على طريقة تثبيتك ويطبع أمر التحديث المطابق له.

أخطاء شائعة — وكيف تتجنبها

الخطأ«hermes: command not found» مباشرة بعد التثبيت.

الصحأعد تحميل الطرفية أو راجع PATH — المثبّت يوضح ذلك؛ سو source ~/.bashrc (أو أعد فتح بوويرشيل) قبل ما تحكم إن فيه فشل.

الخطأ«API key not set» عند أول تشغيل.

الصحنفّذ hermes model وأكمل ضبط المزود، أو ضبط المفتاح مباشرة: hermes config set OPENROUTER_API_KEY مفتاحك.

الخطأتلصق مفتاح API داخل config.yaml.

الصحالمفاتيح مكانها ~/.hermes/.env فقط. استخدم hermes config set والقيمة توصل مكانها الصح لحالها.

الخطأتختار أكبر نموذج محلي على جهاز ضعيف وتلوم Hermes لما يبطّئ.

الصحوازن النموذج مع عتادك، وانتبه لشرط الـ64K سياق، وابدأ بمزود سحابي — ثم حسّن لاحقًا.

الخطأتتخطى التحقق وتبني أتمتة فوق أساس مكسور.

الصحمحادثة نظيفة أولًا، بعدين الطبقات. إذا المحادثة الأساسية ما تشتغل، ولا شي فوقها بيشتغل — صلح الأرضية قبل الدهان.

❓ أسئلة شائعة

أحتاج Hermes Desktop تحديدًا، أم الطرفية تكفي؟

الاثنان يحركان نفس نواة الوكيل. تطبيق سطح المكتب يضيف واجهة محادثة مباشرة وقائمة جلسات ولوحة أوامر وسحب-وإفلات للملفات والإشعارات؛ والطرفية تسوي كل شي من الترمينال. كثير يثبتون الاثنين من نفس المثبّت ويبدلون بينهم بحرية — الإعدادات مشتركة.

كم تكلفة التشغيل؟

البرنامج مجاني. استخدام النموذج هي التكلفة: اشتراكات الدخول (مثل Nous Portal) تجمع كثير نماذج خلف دخول واحد؛ مفاتيح API تحتسب حسب التوكن؛ والنماذج المحلية تكلفتها كهرباء. الإعداد الشخصي الخفيف يبقى عادة متواضعًا؛ والأتمتة الثقيلة تتدرج مع الاستخدام.

أقدر أشغله بدون إنترنت تمامًا؟

نعم، بنموذج محلي عبر سيرفر متوافق مع OpenAI مثل Ollama أو llama.cpp — الوكيل نفسه يشتغل على جهازك بأي حال. بحث الإنترنت والنماذج السحابية وبعض الأدوات طبعًا تحتاج اتصال.

وين تنحفظ جلساتي ومهاراتي؟

كل شي تحت ~/.hermes/ — الجلسات في state.db مع سجلات المحادثات، والمهارات بمجلد skills/، والأسرار بـ.env، والإعدادات بـconfig.yaml. خذ نسخة احتياطية لهذا المجلد وخلاص أخذت نسخة من وكيلك كامل.

ويندوز يقول 'hermes' غير معروف بعد التثبيت.

سكّر بوويرشيل وافتحه من جديد عشان يتحدث PATH، وحاول مرة ثانية. استمرت المشكلة؟ أعد تشغيل المثبّت — يطبع لك الموقع الدقيق لأمر hermes.