> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# استخدم Hermes Agent مع CometAPI

> استخدم هذا الدليل لربط Hermes Agent بـ CometAPI عبر إعدادات chat المتوافقة مع OpenAI أو Anthropic Messages.

استخدم [CometAPI](https://www.cometapi.com) كمزوّد model لـ [Hermes Agent](https://hermes-agent.nousresearch.com/docs/). يدعم Hermes مسارين عبر CometAPI في هذا الدليل: endpoint عام متوافق مع OpenAI لمعظم نماذج النصوص، ومسار Claude عبر Anthropic Messages.

## المتطلبات الأساسية

* Git
* حساب CometAPI مع API key نشط
* طرفية على macOS أو Linux أو WSL2

## التثبيت

<Steps>
  <Step title="احصل على CometAPI API key الخاص بك">
    سجّل الدخول إلى [لوحة تحكم CometAPI](https://www.cometapi.com/console/token). انقر على **Add API Key** وانسخ CometAPI API key الخاص بك.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="لوحة تحكم CometAPI تعرض زر Add API Key" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="تفاصيل CometAPI API key مع عرض base URL" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="ثبّت Hermes Agent">
    يشغّل الأمر التالي أداة التثبيت الرسمية:

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```

    إذا لم تتعرّف shell الحالية على الأمر `hermes` بعد، فأعِد تحميل إعدادات shell:

    ```bash theme={null}
    source ~/.zshrc
    # or
    source ~/.bashrc
    ```

    <Note>
      يخزّن Hermes الإعدادات في `~/.hermes/`، ويربط الأمر `hermes` في `~/.local/bin`، وقد يضيف `~/.local/bin` إلى PATH الخاص بالـ shell.
    </Note>
  </Step>
</Steps>

## الإعداد

اختر مسار CometAPI الذي يطابق عائلة model:

| عائلة model                      | إعداد Hermes                                                                                 | مسار CometAPI               |
| -------------------------------- | -------------------------------------------------------------------------------------------- | --------------------------- |
| نماذج النصوص المتوافقة مع OpenAI | `model.provider: custom` مع `base_url: https://api.cometapi.com/v1`                          | `/v1/chat/completions`      |
| نماذج Claude                     | موفّر مسمّى مع `transport: anthropic_messages`                                               | `/v1/messages`              |
| نماذج Gemini في Hermes           | استخدم الإعداد المتوافق مع OpenAI                                                            | `/v1/chat/completions`      |
| استدعاءات Gemini API المباشرة    | استخدم [واجهة Gemini `generateContent` API](/api/text/gemini-generating-content) خارج Hermes | `/v1beta` `generateContent` |

<Warning>
  لا تُعِد Hermes باستخدام `https://api.cometapi.com/v1beta` كموفّر Gemini أصلي مخصّص. استخدم إعداد Hermes المتوافق مع OpenAI لنماذج Gemini. أما لاستدعاءات Gemini API المباشرة، فاستخدم [واجهة Gemini `generateContent` API](/api/text/gemini-generating-content).
</Warning>

<Steps>
  <Step title="خزّن مفتاح CometAPI الخاص بك">
    افتح `~/.hermes/.env` وأضف القيم التالية:

    ```dotenv theme={null}
    COMETAPI_KEY=<COMETAPI_KEY>
    OPENAI_API_KEY=<COMETAPI_KEY>
    ```

    يُستخدم `COMETAPI_KEY` بواسطة موفّر Claude المسمّى. ويحافظ `OPENAI_API_KEY` على عمل نقطة النهاية الاحتياطية المخصّصة والمتوافقة مع OpenAI في Hermes.
  </Step>

  <Step title="اضبط المسار المتوافق مع OpenAI">
    استخدم هذا المسار لمعظم نماذج النصوص في CometAPI، بما في ذلك نماذج Gemini المستخدمة من Hermes. افتح `~/.hermes/config.yaml` وتأكد من أن قسم `model` يبدو كما يلي:

    ```yaml theme={null}
    model:
      provider: custom
      default: your-model-id
      base_url: https://api.cometapi.com/v1
    ```

    استبدل `your-model-id` بـ model ID حالي لنموذج نصي من [صفحة نماذج CometAPI](https://www.cometapi.com/models/).

    <Note>
      احتفظ بمفتاح API في `~/.hermes/.env`. لا تضع الأسرار بشكل مباشر داخل `config.yaml`.
    </Note>

    <Note>
      يضبط هذا الإعداد نموذج الدردشة الرئيسي. ويمكن لـ Hermes استخدام نماذج مساعدة منفصلة لمهام مثل الرؤية أو استخراج الويب.
    </Note>
  </Step>

  <Step title="اضبط مسار Claude Messages">
    استخدم هذا المسار عندما تريد أن يستدعي Hermes نماذج Claude عبر Anthropic Messages. افتح `~/.hermes/config.yaml` واستخدم موفّرًا مسمّى:

    ```yaml theme={null}
    model:
      provider: cometapi-claude
      default: your-claude-model-id

    providers:
      cometapi-claude:
        base_url: https://api.cometapi.com
        key_env: COMETAPI_KEY
        transport: anthropic_messages
        default_model: your-claude-model-id
    ```

    استبدل `your-claude-model-id` بـ model ID حالي لنموذج Claude من [صفحة نماذج CometAPI](https://www.cometapi.com/models/).

    <Note>
      أبقِ `base_url` على `https://api.cometapi.com` لهذا المسار. يستخدم Hermes نقل Anthropic Messages من الموفّر المسمّى.
    </Note>
  </Step>
</Steps>

## التحقق

<Steps>
  <Step title="تحقق من الإعداد">
    يؤكد الأمر التالي أن Hermes يمكنه قراءة الإعداد ومفتاح API:

    ```bash theme={null}
    hermes config check
    ```

    إذا أبلغ `hermes config check` عن خيارات مفقودة بعد تحديث، فشغّل `hermes config migrate` ثم تحقق مرة أخرى.
  </Step>

  <Step title="شغّل اختبار دردشة حقيقي">
    يرسل الأمر التالي طلبًا حقيقيًا عبر CometAPI:

    ```bash theme={null}
    hermes chat -Q --ignore-rules --max-turns 1 -q "Reply with CONNECTED only."
    ```

    يعيد الإعداد الناجح `CONNECTED` من دون أخطاء مصادقة أو أخطاء في نقطة النهاية. وعندما يكون إعداد Claude Messages نشطًا، فهذا يؤكد أن Hermes يمكنه استخدام النقل `anthropic_messages` عبر CometAPI.
  </Step>
</Steps>

## إعداد اختياري

<AccordionGroup>
  <Accordion title="إعادة تثبيت نظيفة (اختياري)">
    إذا كنت تستبدل تثبيت Hermes أقدم، فاستخدم أداة إلغاء التثبيت المدمجة أولًا:

    ```bash theme={null}
    hermes uninstall
    ```

    في أداة إلغاء التثبيت، اختر **Full uninstall** لإزالة CLI وإدخال PATH وبيانات `~/.hermes/`. ثم أعد تشغيل خطوة التثبيت وتابع باستخدام إعدادات CometAPI نفسها.
  </Accordion>

  <Accordion title="استخدم model الخاص بـ hermes بدلًا من ذلك (اختياري)">
    إذا كنت تفضّل التدفق التفاعلي لمسار OpenAI-compatible، شغّل `hermes model` واختر **Custom endpoint**.

    ثم أدخل القيم التالية:

    * Base URL: `https://api.cometapi.com/v1`
    * API key: مفتاح CometAPI API الخاص بك
    * Model: model ID حالي لنموذج نصي من CometAPI

    يكتب هذا التدفق إعدادات المزوّد OpenAI-compatible داخل `config.yaml`. بالنسبة إلى Claude Messages، حرّر `config.yaml` مباشرةً بحيث يحتفظ المزوّد المُسمّى بالقيمة `transport: anthropic_messages`.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#howto",
        "name": "استخدام Hermes Agent مع CometAPI",
        "description": "استخدم هذا الدليل لربط Hermes Agent بـ CometAPI من خلال إعدادات الدردشة المتوافقة مع OpenAI أو Anthropic Messages.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-1",
            "position": 1,
            "name": "احصل على مفتاح CometAPI API الخاص بك",
            "text": "أنشئ حساب CometAPI الخاص بك أو افتحه، ثم انسخ مفتاح API نشطًا من لوحة التحكم."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-2",
            "position": 2,
            "name": "تثبيت Hermes Agent",
            "text": "أكمل خطوة تثبيت Hermes Agent في دليل استخدام Hermes Agent مع CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-3",
            "position": 3,
            "name": "خزّن مفتاح CometAPI الخاص بك",
            "text": "أكمل خطوة تخزين مفتاح CometAPI الخاص بك في دليل استخدام Hermes Agent مع CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-4",
            "position": 4,
            "name": "تهيئة المسار المتوافق مع OpenAI",
            "text": "أكمل خطوة تهيئة المسار المتوافق مع OpenAI في دليل استخدام Hermes Agent مع CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-5",
            "position": 5,
            "name": "تهيئة مسار Claude Messages",
            "text": "أكمل خطوة تهيئة مسار Claude Messages في دليل استخدام Hermes Agent مع CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-6",
            "position": 6,
            "name": "تحقق من الإعدادات",
            "text": "أكمل خطوة التحقق من الإعدادات في دليل استخدام Hermes Agent مع CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-7",
            "position": 7,
            "name": "شغّل اختبار دردشة حقيقي",
            "text": "أكمل خطوة تشغيل اختبار دردشة حقيقي في دليل استخدام Hermes Agent مع CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "توثيق CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "التكاملات",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "استخدام Hermes Agent مع CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/hermes-agent"
          }
        ]
      }
    ]
    }
    `}
</script>