Hermes Agent + DeepSeek على شبكة Gonka — وكيل ذاتي بتكلفة زهيدة

تثبيت Hermes (على Linux وmacOS وWSL2). سيقوم المثبّت الرسمي بجلب Python وNode.js وripgrep وffmpeg تلقائيًا:

# Linux / macOS / WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

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

بعد التثبيت، أعد تحميل الـ shell وتأكد من التشغيل:

source ~/.bashrc   # or ~/.zshrc
hermes             # interactive CLI

مفتاح API من JoinGonka: إن لم يكن لديك بعد — سجّل على gate.joingonka.ai/register، وأكّد العنوان — وستصل إلى حسابك 3M من الرموز المجانية — ثم أنشئ مفتاحًا ببادئة jg- في Dashboard. مفتاح واحد ورصيد واحد يعملان فورًا مع كل النماذج.

يعمل Hermes مع أي endpoint متوافق مع OpenAI: إذا استجاب الخادم عند /v1/chat/completions — فيمكنك توجيه Hermes إليه. بوابة JoinGonka هي بالضبط ذلك. هناك ثلاث طرق للإعداد.

الطريقة 1: مثبّتنا (أمر واحد، مُوصى به). سيكتب المزوّد في إعدادات Hermes، ويضع DeepSeek V4 Flash كطراز افتراضي، وسيتحقق عبر طلب حيّ من أن البوابة تقبل المفتاح والطراز:

npx @joingonka/setup --tool hermes

الطريقة 2: معالج الإعداد. شغّله في الطرفية خارج الجلسة النشطة:

hermes model

في قائمة المزوّدين اختر «Custom endpoint (self-hosted / VLLM / etc.)» وأدخل ثلاث قيم:

• API base URL: https://gate.joingonka.ai/v1
• API key: jg-your-key
• Model name: deepseek-ai/DeepSeek-V4-Flash-0731

الطريقة 3: تعديل الإعدادات. يحفظ Hermes إعدادات الطرازات في ~/.hermes/config.yaml (في البناء الأصلي لويندوز — %LOCALAPPDATA%\hermes\config.yaml) — وهو المصدر الوحيد للحقيقة. أضف القسم:

# ~/.hermes/config.yaml
model:
  provider: custom
  default: deepseek-ai/DeepSeek-V4-Flash-0731
  base_url: https://gate.joingonka.ai/v1
  api_key: jg-your-key

يُكتب اسم الطراز في المفتاح default — وهو المفتاح الأساسي في Hermes. السطر model: داخل الكتلة مجرد اسم بديل احتياطي: لا يسري إذا كان default مضبوطًا بالفعل (مثلًا بواسطة معالج الإعداد)، لذا عند التعديل اليدوي غيّر default تحديدًا.

⚠️ المفتاح في model.api_key فقط. تسمح وثائق Hermes بوضع OPENAI_API_KEY في ~/.hermes/.env، لكن هذا لا يعمل مع endpoint مخصص: يقرأ Hermes المفتاح من model.api_key فقط، ومع المفتاح في .env ستردّ البوابة بـ 401 Invalid API key. تم التحقق على Hermes v0.20.4.

التحقق: شغّل hermes واكتب «أنشئ ملف hello.py يحتوي على دالة hello world». يجب أن ينشئ الوكيل الملف ويعرض النتيجة. يمكن رؤية حالة الإعداد الحالي عبر hermes config show | grep '^model\.' وhermes status.

التبديل الفوري: داخل الجلسة بالأمر /model custom:deepseek-ai/DeepSeek-V4-Flash-0731. أما /model custom بدون اسم فسيجلب الطراز تلقائيًا من endpoint إذا كان هناك طراز واحد فقط.

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

مع JoinGonka Gateway يمكن إبقاء Hermes يعمل على مدار الساعة: تقارير ليلية، تدقيق أسبوعي، مهام خلفية عبر مجدول cron — دون القلق بشأن الفاتورة. بأسعار Anthropic، كان سيتعين حساب كل عملية تشغيل من هذا النوع يدوياً. يكفي الرصيد الأولي عند التسجيل لتشغيل الوكيل على مهمة حقيقية ورؤية استهلاكك الخاص قبل أول عملية شحن.

من خلال Gateway، يمكن للمستخدم الوصول فوراً إلى ثلاثة نماذج من Gonka — جميعها تدعم الـ tool calling الأصلي (OpenAI function calling)، لذا تعمل مهارات وأدوات Hermes بشكل موثوق دون الحاجة إلى معالجة النصوص:

حول حدود الـ tokens في Hermes. في config.yaml، حقل context_length هو نافذة السياق الكاملة (إدخال + إخراج)، بينما max_tokens هو سقف لطول الاستجابة فقط. يُفضل عدم تعيين كليهما: سيحدد Hermes القيم الصحيحة تلقائياً من المزود. إذا قمت بتعيين max_tokens يدوياً، احتفظ به ضمن حدود النموذج: عبر Gateway، هذا هو 32768 لـ DeepSeek V4 Flash و 8192 لـ MiniMax M2.7 و GLM-5.3 Flash. يمكنك تبديل النموذج في أي لحظة باستخدام أمر hermes model أو مباشرة في الجلسة عبر /model.

أدوات طرفية مشابهة في قاعدة معرفتنا: Claude Code, Cline.