⚙️

Module 03 — الموديول الثالث

Hermes Setup

التثبيت والإعداد — من أول سطر لـ working setup كامل

14 Slides تفاعلي تطبيق عملي

Slide 2 — التثبيت في سطر واحد

التثبيت في سطر واحد

أسرع طريقة لتثبيت Hermes Agent

🐧

Linux / macOS / WSL2 / Android (Termux)

bash

# سطر واحد — بيحمل ويثبت كل حاجة تلقائياً
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

🪟

Windows (Native) — PowerShell

powershell

# Windows native — من غير WSL
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

ℹ️

بعد التثبيت

شغّل source ~/.bashrc أو source ~/.zshrc وبعدين hermes — على Windows افتح terminal جديد.

Slide 3 — ماذا يفعل المثبّت

ماذا يفعل المثبّت

الـ installer بيعمل كل حاجة تلقائياً

📦

uv

Python package manager سريع جداً — بدل pip التقليدية

🐍

Python 3.10+

الـ runtime الأساسي اللي بيشغل عليه Hermes

⬢

Node.js

مطلوب للـ TUI — واجهة الطرفية الكاملة

🔍

ripgrep

أداة بحث سريعة جداً في الملفات — بتستخدمها الـ skills

🎬

ffmpeg

معالجة الصوت والفيديو — مطلوب للـ voice mode

نوع التثبيت	الكود	أمر hermes	دليل البيانات
Per-user (عادي)	`~/.hermes/hermes-agent/`	`~/.local/bin/hermes`	`~/.hermes/`
Root-mode (sudo)	`/usr/local/lib/hermes-agent/`	`/usr/local/bin/hermes`	`/root/.hermes/`

Slide 4 — معالج الإعداد

معالج الإعداد

أول ما تشغل hermes هيلك wizard خطوة بخطوة

Terminal — hermes setup

$ hermes setup 🔧 Hermes Agent Setup Wizard ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Step 1/4: Choose your LLM provider → Nous Portal (recommended) → OpenRouter / OpenAI / Anthropic → Ollama (local) / vLLM (local) Step 2/4: Enter API Key (if needed) Step 3/4: Choose your model Step 4/4: Enable toolsets ✓ Setup complete!

💡

Quick Setup — الوضع السريع

سطر واحد بس: hermes setup --portal — OAuth مع Nous Portal وتفعيل كل الـ Tool Gateway.

Slide 5 — اختيار مزوّد النموذج

مزوّدو نماذج اللغة

أهم خطوة في كل الـ setup

Provider	الوصف	طريقة الإعداد
Nous Portal	اشتراك واحد — 300+ model + Tool Gateway	`hermes setup --portal`
OpenRouter	توجيه بين مئات الـ models	`OPENROUTER_API_KEY` في `.env`
OpenAI	GPT models مباشرة	`OPENAI_API_KEY` في `.env`
Anthropic	Claude models	`ANTHROPIC_API_KEY` أو OAuth
Ollama (Local)	نماذج محلية — بدون إنترنت	`hermes model` ← custom endpoint
vLLM (Local)	أداء عالي للـ GPU	`hermes model` ← custom endpoint

⚠️

ملاحظة

اختيار الـ provider قرار مهم — لو مش متأكد، ابدأ بـ Nous Portal لأنه الأسهل والأسرع في الإعداد.

Slide 6 — واجهة سطر الأوامر

واجهة سطر الأوامر

الواجهة الكلاسيكية — بسيطة وسريعة

bash

# الوضع التفاعلي
hermes                    # interactive mode
hermes chat               # نفس الشيء

# رسالة واحدة وخلاص
hermes chat -q "مرحبا"

📊

hermes status

حالة الـ gateway

⚙️

hermes config

عرض الإعدادات

📡

hermes channels list

القنوات المتصلة

🤖

hermes models list

الـ models المتاحة

📋

hermes logs

عرض الـ logs

Slide 7 — واجهة TUI

واجهة TUI

واجهة كاملة في الـ terminal — أحسن تجربة تفاعلية

Terminal — hermes --tui

$ hermes --tui ╭─────────────────────────────────────╮ │ 🐙 Hermes Agent — TUI Mode │ │ Model: openrouter:claude-3 │ ╰─────────────────────────────────────╯ > Type your message... /new /model /usage /skills /exit

Multi-line editing: Ctrl+J أو Alt+Enter

Autocomplete: اكتب / واضغط Tab

Session management: تصفح واستئناف الجلسات

Tool panels: شوف الأدوات في الوقت الحقيقي

Slash Commands

            # أوامر Slash الأساسية داخل TUI

/new              # جلسة جديدة

/model            # عرض/تغيير النموذج

/model openrouter:claude-3    # تغيير لـ model معين

/usage            # عرض استهلاك الـ tokens

/compress         # ضغط الـ context يدوياً

/skills           # تصفح الـ skills

/stop             # إيقاف العمليات الجارية

/exit             # الخروج

Slide 8 — تخصيص الإعدادات

config.yaml

كل الإعدادات في ملف واحد: ~/.hermes/config.yaml

yaml — config.yaml

model:
  default: openrouter:auto
  fallback: openrouter:claude-3-haiku

memory:
  nudges:
    enabled: true
    interval: 10

gateway:
  telegram:
    enabled: true
    token: "YOUR_TOKEN"

transcription:
  provider: whisper

📋

عرض الإعدادات

hermes config show

✏️

تعديل قيمة

hermes config set model.default "openrouter:auto"

📂

فتح الملف

hermes config edit

💡

قاعدة مهمة

الـ secrets (API keys, tokens) في .env — والباقي في config.yaml. أولوية الإعدادات: CLI args > config.yaml > .env > defaults.

Slide 9 — توصيل Telegram

إعداد Telegram

4 خطوات بسيطة وتكون متصل

1️⃣

إنشاء Bot

افتح @BotFather في Telegram وأرسل /newbot

2️⃣

إضافة Token

شغّل hermes gateway setup والصق الـ token

3️⃣

تحديد Users

حدد المستخدمين المسموح لهم بـ allowed_users

4️⃣

تشغيل Gateway

شغّل hermes gateway start وتحقق بـ hermes channels list

Terminal — Telegram Setup

$ hermes gateway setup ? Select channel: Telegram ? Bot token: ******** ? Your user ID: 123456789 ✓ Telegram configured! $ hermes gateway start ✓ Gateway running — Telegram connected ✅

Slide 10 — تبديل النماذج

تبديل النماذج

بدّل بين الـ models بسهولة أثناء المحادثة

inside session

# أثناء المحادثة (داخل Session)
/model                              # عرض الـ models المتاحة
/model claude-sonnet-4              # لـ model معين
/model openrouter:claude-3          # لـ provider + model
/model custom:local:qwen-2.5        # لـ custom endpoint

outside session

# من الـ Terminal (خارج Session) — wizard كامل
hermes model

# تعيين نموذج افتراضي دائم
hermes config set model.default "openrouter:anthropic/claude-sonnet-4"

ℹ️

ملاحظة

/model بيسمحلك تبدل بين الـ providers اللي موجودة بس. لو عايز تضيف provider جديد، اخرج من الـ session وشغل hermes model.

Slide 11 — أداة التشخيص

hermes doctor

أول أمر تشغله لما حاجة مش بتشتغل

Terminal — hermes doctor

$ hermes doctor 🔍 Hermes Agent Doctor ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ✅ Python version: 3.11.5 (meets requirement) ✅ Hermes Agent version: v0.13.0 ✅ Config file exists: ~/.hermes/config.yaml ✅ LLM connection normal: openrouter/claude-sonnet-4 ✅ Memory system normal: ~/.hermes/memory/ ✅ Skills directory normal: ~/.hermes/skills/ ✅ Disk space sufficient: 45GB available ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Diagnosis complete: 7/7 checks passed ✅

🔍

فحوصات محددة

hermes doctor --check llm
hermes doctor --check gateway
hermes doctor --check system

🔧

إصلاح تلقائي

hermes doctor --fix
بيحاول يصلح المشاكل الشائعة تلقائياً — مش بيغير الـ API keys.

Slide 12 — التثبيت على Windows

التثبيت على Windows

Hermes بيشتغل native على Windows 10 و 11 — من غير WSL أو Docker

powershell

# التثبيت — PowerShell أو Windows Terminal
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

# خيارات متقدمة
& ([scriptblock]::Create((irm https://hermes-agent.nousresearch.com/install.ps1))) -NoVenv -SkipSetup

# بعد التثبيت — افتح terminal جديد (مهم!)
hermes

الباراميتر	الافتراضي	الوظيفة
`-Branch`	`main`	تثبيت branch معين
`-Commit`	—	تثبيت commit محدد
`-Tag`	—	تثبيت tag محدد
`-NoVenv`	off	تخطي إنشاء venv
`-SkipSetup`	off	تخطي wizard بعد التثبيت

⚠️

ملاحظات مهمة

مفيش حاجة لـ WSL — Hermes بيشغل native. الـ TUI محتاج Node.js ≥ 20 (الـ installer بيثبته لو مش موجود). لو حصل مشكلة في الـ BOM: irm https://hermes-agent.nousresearch.com/install.ps1 | iex

Slide 13 — تمرين عملي

تمرين عملي

طبّق كل اللي اتعلمته في مشروع واحد كامل

🚀

Project: Full Hermes Setup

ثبّت، اضبط، وشغّل — من الصفر

1️⃣

ثبّت Hermes على جهازك باستخدام أمر التثبيت في سطر واحد

2️⃣

شغّل Setup Wizard — hermes setup — واختر OpenRouter كـ provider

3️⃣

جرب TUI — hermes --tui — وقارنها بالـ CLI العادي

4️⃣

شغّل Doctor — hermes doctor — وتأكد إن كل الفحوصات ناجحة

5️⃣

وصّل Telegram — اعمل bot عبر @BotFather وضيفه لـ Hermes

💡

نصيحة

لو مش عندك Telegram، خطوة 5 اختيارية — المهم إنك توصل لـ working setup مع LLM provider واحد على الأقل.

Slide 14 — اختبار المعرفة

اختبار

اختبر نفسك — 5 أسئلة سريعة

اختبار الموديول 3

Score: 0/5

Q1: ما هو أمر التثبيت في سطر واحد على Linux/macOS؟

npm install -g hermes-agent

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

pip install hermes-agent

apt-get install hermes

Q2: أي ده مش من الأشياء اللي بيثبتها الـ installer تلقائياً؟

uv (Python package manager)

Node.js

Docker

ffmpeg

Q3: ما هو الأمر اللي بتستخدمه لتشغيل واجهة TUI؟

hermes --gui

hermes --tui

hermes terminal

hermes interactive

Q4: فين بتضع الـ secrets مثل API keys و tokens؟

config.yaml

في الـ CLI arguments

.env file

في الـ terminal history

Q5: ما هو أول أمر تشغله لما حاجة مش بتشتغل؟

hermes status

hermes logs

hermes doctor

hermes debug