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

# Hermes Agent

> اضبط Venice كمزوّد النماذج في Hermes Agent للحصول على ذكاء اصطناعي خاص وغير مُقيَّد مع ذاكرة دائمة، ومهارات مخصصة، ومراسلة متعددة المنصات.

[Hermes Agent](https://hermes-agent.nousresearch.com) هو وكيل ذكاء اصطناعي مفتوح المصدر، ذاتي الاستضافة، بُني بواسطة [Nous Research](https://nousresearch.com). يتميز بذاكرة دائمة، وإنشاء مهارات مستقل، وحلقة تعلم مدمجة تصبح أكثر قدرة كلما طال تشغيلها. وجّهه إلى Venice API ليحصل وكيلك على الوصول إلى أكثر من 230 نموذجًا وأدوات عبر النصوص والصور والفيديو والصوت والـ embeddings والمزيد.

<Card title="مستندات Hermes Agent" icon="arrow-up-right-from-square" href="https://hermes-agent.nousresearch.com/docs/">
  وثائق كاملة وإعداد المزود وخيارات التكوين على المستندات الرسمية لـ Hermes Agent.
</Card>

## لماذا Venice + Hermes Agent؟

يمنح Venice API وكيل Hermes Agent الخاص بك الوصول إلى منصة Venice الكاملة عبر نقطة نهاية واحدة متوافقة مع OpenAI.

| القدرة               | ما تحصل عليه                                                |
| -------------------- | ----------------------------------------------------------- |
| **النصوص والمحادثة** | نماذج خاصة ومجهّلة الهوية (GLM، Qwen، Claude، GPT، والمزيد) |
| **الصور**            | التوليد، والتحرير، والترقية، وإزالة الخلفية                 |
| **الفيديو**          | التوليد والنسخ النصي                                        |
| **الصوت**            | تركيب الكلام (TTS)، وتوليد الموسيقى، وتحويل الكلام إلى نص   |
| **Embeddings**       | تضمينات متجهية لـ RAG والبحث الدلالي                        |
| **الأدوات**          | كشط الويب، والبحث على الويب، وتحليل النصوص، و crypto RPC    |

<CardGroup cols={3}>
  <Card title="استدلال خاص" icon="shield-halved">
    لا يوجد احتفاظ بالبيانات. لا تُخزَّن المطالبات أو تُسجَّل أبدًا
  </Card>

  <Card title="ذاكرة دائمة" icon="brain">
    يتذكر Hermes السياق عبر الجلسات وإعادات التشغيل
  </Card>

  <Card title="أكثر من 15 منصة" icon="comments">
    اوصل إلى وكيلك على Telegram و Discord و Slack و WhatsApp والمزيد
  </Card>
</CardGroup>

## الإعداد

### 1. تثبيت Hermes Agent

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={"system"}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```
  </Tab>

  <Tab title="WSL2 (Windows)">
    ثبّت [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install) أولًا، ثم شغّل نفس الأمر:

    ```bash theme={"system"}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```
  </Tab>
</Tabs>

بعد التثبيت، أعد تحميل shell الخاص بك:

```bash theme={"system"}
source ~/.zshrc   # أو: source ~/.bashrc
```

### 2. تكوين Venice كمزودك

شغّل معالج إعداد النموذج:

```bash theme={"system"}
hermes model
```

اختر **Custom endpoint (self-hosted / VLLM / etc.)** وأدخل ما يلي عند الطلب:

| الحقل            | القيمة                          |
| ---------------- | ------------------------------- |
| **API base URL** | `https://api.venice.ai/api/v1`  |
| **API key**      | مفتاح Venice API الخاص بك       |
| **Model name**   | معرّف نموذج Venice (انظر أدناه) |

احصل على مفتاح API من [venice.ai/settings/api](https://venice.ai/settings/api) إذا لم يكن لديك واحد بعد.

<Tip>
  يمكنك أيضًا تكوين Venice مباشرة في `~/.hermes/config.yaml`:

  ```yaml theme={"system"}
  model:
    default: zai-org-glm-5
    provider: custom
    base_url: https://api.venice.ai/api/v1
    api_key: ${VENICE_API_KEY}
  ```

  وعيّن المفتاح في `~/.hermes/.env`:

  ```bash theme={"system"}
  VENICE_API_KEY=your-key-here
  ```
</Tip>

### 3. اختر نموذجًا

عندما يطلب المعالج نموذجًا، اختر واحدًا بناءً على حالة استخدامك:

| حالة الاستخدام   | النموذج                 | الخصوصية     |
| ---------------- | ----------------------- | ------------ |
| عام              | `zai-org-glm-5`         | خاص          |
| تفكير منطقي      | `kimi-k2-6`             | خاص          |
| برمجة            | `claude-opus-4-7`       | مجهّل الهوية |
| رؤية             | `z-ai-glm-5v-turbo`     | مجهّل الهوية |
| غير خاضع للرقابة | `venice-uncensored-1-2` | خاص          |

غيّر نموذجك في أي وقت دون الحاجة إلى إعادة تشغيل:

```bash theme={"system"}
hermes model              # المعالج الكامل
```

أو بدّل في منتصف الجلسة:

```text theme={"system"}
/model custom:claude-opus-4-7
```

### 4. ابدأ الدردشة

افتح CLI الكلاسيكي أو TUI الحديث:

```bash theme={"system"}
hermes            # CLI كلاسيكي
hermes --tui      # TUI حديث (موصى به)
```

جرب مطالبة للتحقق من أن كل شيء يعمل:

```text theme={"system"}
Summarize this repo in 5 bullets and tell me what the main entrypoint is.
```

## وصل منصات المراسلة

بمجرد عمل CLI، وصّل تطبيقات المراسلة الخاصة بك من خلال البوابة:

```bash theme={"system"}
hermes gateway setup
```

يرشدك هذا خلال توصيل Telegram و Discord و Slack و WhatsApp و Signal ومنصات أخرى. يصبح وكيلك قابلًا للوصول من أي قناة متصلة، كلها مدعومة بـ Venice.

```bash theme={"system"}
hermes gateway      # ابدأ بوابة المراسلة
```

## أوضاع الخصوصية

تتبع نماذج Venice في Hermes Agent نفس [مستويات الخصوصية](/overview/privacy) مثل Venice API:

* نماذج **Private** (GLM، Qwen، DeepSeek، Llama، Venice Uncensored) تعمل على أسطول GPU الخاص بـ Venice. لا تُخزَّن المطالبات أو تُسجَّل أبدًا.
* نماذج **Anonymized** (Claude، GPT، Gemini، Grok) يتم توجيهها عبر Venice مع إزالة جميع المعلومات المعرّفة. يرى المزود الخارجي Venice كعميل، وليس أنت.

## مهارات Venice API

يحتوي Hermes Agent على نظام مهارات مدمج متوافق مع تنسيق [Agent Skills](https://github.com/veniceai/skills). تنشر Venice مهارات رسمية تعلّم وكيلك كيفية استخدام كل نقطة نهاية Venice (الدردشة، توليد الصور، الفيديو، الصوت، embeddings، أدوات augment، والمزيد).

ثبّت مهارات Venice مباشرة من GitHub:

```bash theme={"system"}
hermes skills install veniceai/skills
```

أو ابحث عن مهارات فردية:

```bash theme={"system"}
hermes skills search venice
```

سيكتشف Hermes كل مهارة عبر frontmatter في `SKILL.md` ويحمّلها عند الطلب.

## الأوامر الرئيسية

| الأمر               | الوصف                  |
| ------------------- | ---------------------- |
| `hermes`            | ابدأ الدردشة           |
| `hermes model`      | غيّر المزود أو النموذج |
| `hermes tools`      | كوّن الأدوات الممكّنة  |
| `hermes gateway`    | ابدأ بوابة المراسلة    |
| `hermes --continue` | استأنف جلستك الأخيرة   |
| `hermes doctor`     | شخّص المشكلات          |
| `hermes update`     | حدّث إلى أحدث إصدار    |

## الموارد

<CardGroup cols={2}>
  <Card title="مستندات Hermes Agent" icon="book" href="https://hermes-agent.nousresearch.com/docs/">
    الوثائق الرسمية
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/NousResearch/hermes-agent">
    شفرة المصدر والإصدارات
  </Card>

  <Card title="كتالوج نماذج Venice" icon="list" href="/models/text">
    تصفح النماذج المتاحة
  </Card>

  <Card title="خصوصية Venice" icon="shield-halved" href="/overview/privacy">
    كيف تحمي Venice بياناتك
  </Card>
</CardGroup>