Hermes Agent: التثبيت
آخر تحديث: 2026-08-31
تثبيت Hermes Agent مثل إعداد مساعد تعليمي على حاسوبك — ثبّته مرة واحدة، وهو دائمًا جاهز للمساعدة.
💡 نصيحة: التثبيت عبر pip هو الأبسط والأسرع. Docker مثالي لنشر الخوادم. النسخة المكتبية مناسبة للمستخدمين غير التقنيين.
📋 المتطلبات المسبقة: الدرس 1 — المقدمة والميزات الأساسية
1. ما ستتعلمه
| # | المحتوى |
|---|---|
| ❶ | متطلبات النظام وفحص البيئة |
| ❷ | التثبيت عبر pip (موصى به) |
| ❸ | التثبيت من الكود المصدري |
| ❹ | التثبيت عبر Docker |
| ❺ | التحقق من التثبيت وحل المشاكل |
2. القصة
(1) المشكلة: لا يمكن تشغيل البيئة
Bob يريد تجربة Hermes Agent، لكن إصدار Python خاطئ، تضارب في التبعيات، مشاكل صلاحيات... قضى بعد الظهر ولم يتمكن من تشغيله.
(2) الحل: أمر واحد للتثبيت
Alice استخدمت pip للتثبيت في دقيقتين:
BASH
pip install hermes-agent
hermes init
hermes chat
# ✅ جاهز!
3. متطلبات النظام
| المكون | الحد الأدنى | الموصى به |
|---|---|---|
| Python | 3.10+ | 3.12 |
| RAM | 4 GB | 8+ GB |
| التخزين | 1 GB | 5+ GB |
| النظام | Windows/macOS/Linux | أي |
BASH
# فحص البيئة
python --version # Python 3.10+
pip --version # pip 23+
git --version # git 2.30+ (اختياري)
4. التثبيت عبر pip (موصى به)
BASH
# تثبيت أساسي
pip install hermes-agent
# تثبيت مع جميع الامتدادات
pip install hermes-agent[all]
# تثبيت مع دعم النماذج المحلية
pip install hermes-agent[ollama]
# تثبيت مع دعم سطح المكتب
pip install hermes-agent[desktop]
التهيئة الأولى
BASH
hermes init
# ? مفتاح OpenAI API: sk-... (أو اضغط Enter للتخطي)
# ? النموذج الافتراضي: gpt-4o-mini
# ? اللغة المفضلة: en
# ? اسم المستخدم: Alice
# ✅ التهيئة اكتملت!
# تم إنشاء ملف الإعداد: ~/.hermes/config.yaml
5. التثبيت من الكود المصدري
BASH
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
pip install -e ".[all]"
hermes init
6. التثبيت عبر Docker
BASH
# سحب الصورة
docker pull nousresearch/hermes-agent:latest
# تشغيل مع تكوين
docker run -it \
-v ~/.hermes:/root/.hermes \
-e OPENAI_API_KEY="${OPENAI_API_KEY}" \
nousresearch/hermes-agent:latest \
hermes init
# بدء المحادثة
docker run -it \
-v ~/.hermes:/root/.hermes \
-e OPENAI_API_KEY="${OPENAI_API_KEY}" \
nousresearch/hermes-agent:latest \
hermes chat
7. التثبيت على سطح المكتب
BASH
# macOS
brew install --cask hermes-agent
# Windows
winget install HermesAgent.Hermes
# Linux (AppImage)
wget https://hermes.dev/downloads/hermes-agent-latest.AppImage
chmod +x hermes-agent-latest.AppImage
./hermes-agent-latest.AppImage
8. التحقق من التثبيت
BASH
# فحص سريع
hermes --version
# Hermes Agent v1.0.0
# فحص شامل
hermes doctor
# ✅ Python: 3.12.0
# ✅ Config: ~/.hermes/config.yaml
# ✅ OpenAI API: Connected
# ✅ Memory System: OK
# ✅ Tools Registry: 72 tools loaded
# ⚠️ Ollama: Not installed (optional)
مشاكل التثبيت الشائعة
| المشكلة | السبب | الحل |
|---|---|---|
python غير موجود |
Python غير مثبت | ثبّت Python 3.10+ |
pip install فشل |
صلاحيات غير كافية | استخدم pip install --user |
| لا يمكن الوصول إلى API | مفتاح API غير صالح | تحقق من OPENAI_API_KEY |
| بطيء على macOS | بنية ARM | استخدم pip install hermes-agent[arm] |
❓ أسئلة شائعة
س أي طريقة تثبيت أفضل؟
ج pip للمطورين، Docker للخوادم، سطح المكتب للمستخدمين غير التقنيين.
س هل يمكنني استخدام النماذج المحلية فقط بدون API Key؟
ج نعم. ثبّت Ollama (
pip install hermes-agent[ollama])، اسحب نموذجًا (ollama pull llama3.2)، واستخدم --offline.س كيف أحدّث Hermes Agent؟
ج
pip install --upgrade hermes-agent. التكوين والبيانات لن تتأثر.س هل التثبيت على Windows مستقر؟
ج نعم. Windows 10/11 مدعوم بالكامل. WSL2 يعطي أفضل تجربة.
📖 ملخص
- pip التثبيت الأبسط:
pip install hermes-agent→hermes init→hermes chat - Docker للخوادم: عزل البيئة، سهولة النشر
- سطح المكتب للمستخدمين غير التقنيين: macOS/Windows/Linux
hermes doctorللفحص الشامل بعد التثبيت- النماذج المحلية (Ollama) تتيح التشغيل بدون اتصال بالكامل
📝 تمارين
- أساسي (⭐): ثبّت Hermes Agent عبر pip، شغّل
hermes doctor، أكمل أول محادثة. - متوسط (⭐⭐): ثبّت Ollama + نموذج محلي، تحقق من التشغيل بدون اتصال
hermes chat --offline. - متقدم (⭐⭐⭐): استخدم Docker Compose لنشر Hermes + Ollama + Web UI، تحقق من أن المكدس الكامل يعمل.
