nousresearch/hermes-agentالوكيل الذي ينمو معك
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/7225/75e85ef6fecf5a6227985f2082e5b35331fceff4d8db03720c82a7d9ee8b7eea.png" alt="Hermes Agent" width="100%">
</p>
# Hermes Agent ☤
<p align="center">
<a href="https://hermes-agent.nousresearch.com/">Hermes Agent</a> | <a href="https://hermes-agent.nousresearch.com/">Hermes Desktop</a>
</p>
<p align="center">
<a href="https://hermes-agent.nousresearch.com/docs/"><img src="https://img.shields.io/badge/Docs-hermes--agent.nousresearch.com-FFD700?style=for-the-badge" alt="Documentation"></a>
<a href="https://discord.gg/NousResearch"><img src="https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
<a href="https://github.com/NousResearch/hermes-agent/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="License: MIT"></a>
<a href="https://nousresearch.com"><img src="https://img.shields.io/badge/Built%20by-Nous%20Research-blueviolet?style=for-the-badge" alt="Built by Nous Research"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.zh-CN.md"><img src="https://img.shields.io/badge/Lang-%E4%B8%AD%E6%96%87-red?style=for-the-badge" alt="中文"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.ur-pk.md"><img src="https://img.shields.io/badge/Lang-%D8%A7%D8%B1%D8%AF%D9%88-green?style=for-the-badge" alt="اردو"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.es.md"><img src="https://img.shields.io/badge/Lang-Espa%C3%B1ol-orange?style=for-the-badge" alt="Español"></a>
</p>
**وكيل الذكاء الاصطناعي ذاتي التحسين الذي طوّرته [Nous Research](https://nousresearch.com).** إنه الوكيل الوحيد المزوّد بحلقة تعلّم مدمجة — فهو ينشئ مهارات من التجربة، ويحسّنها أثناء الاستخدام، ويحثّ نفسه على حفظ المعرفة، ويبحث في محادثاته السابقة، ويبني نموذجًا متعمقًا لهويتك عبر الجلسات. شغّله على خادم VPS بقيمة 5 دولارات، أو على عنقود GPU، أو على بنية تحتية بلا خوادم لا تكاد تكلّف شيئًا عند الخمول. إنه غير مرتبط بحاسوبك المحمول — تحدّث إليه من Telegram بينما يعمل على جهاز افتراضي سحابي.
استخدم أي نموذج تريده — [Nous Portal](https://portal.nousresearch.com)، أو OpenRouter، أو OpenAI، أو نقطة النهاية الخاصة بك، و[العديد غيرها](https://hermes-agent.nousresearch.com/docs/integrations/providers). بدّل باستخدام `hermes model` — دون تغييرات في الشيفرة، ودون تقييد بمزوّد واحد.
<table>
<tr><td><b>واجهة طرفية حقيقية</b></td><td>واجهة TUI كاملة مع تحرير متعدد الأسطر، وإكمال تلقائي لأوامر الشرطة المائلة، وسجل المحادثات، والمقاطعة وإعادة التوجيه، وبثّ مخرجات الأدوات.</td></tr>
<tr><td><b>يعيش حيث تعيش</b></td><td>Telegram وDiscord وSlack وWhatsApp وSignal وCLI — كلها من عملية بوابة واحدة. نسخ المذكرات الصوتية، واستمرارية المحادثات عبر المنصات.</td></tr>
<tr><td><b>حلقة تعلّم مغلقة</b></td><td>ذاكرة ينسّقها الوكيل مع تنبيهات دورية. إنشاء مهارات ذاتي بعد المهام المعقدة. المهارات تحسّن نفسها أثناء الاستخدام. بحث في الجلسات باستخدام FTS5 مع تلخيص بواسطة LLM للاسترجاع عبر الجلسات. نمذجة جدلية للمستخدم عبر <a href="https://github.com/plastic-labs/honcho">Honcho</a>. متوافق مع معيار <a href="https://agentskills.io">agentskills.io</a> المفتوح.</td></tr>
<tr><td><b>أتمتة مجدولة</b></td><td>مجدول cron مدمج مع التسليم إلى أي منصة. تقارير يومية، ونسخ احتياطية ليلية، ومراجعات أسبوعية — كلها باللغة الطبيعية، وتعمل دون إشراف.</td></tr>
<tr><td><b>يفوّض ويوازي</b></td><td>أنشئ وكلاء فرعيين معزولين لمسارات عمل متوازية. في Desktop، اختر مزوّدهم ونموذجهم وحدودهم من Settings → Model → Subagents، ثم طبّق المسار الكامل. اكتب سكربتات Python تستدعي الأدوات عبر RPC، مما يحوّل خطوط الأنابيب متعددة الخطوات إلى دورات بتكلفة سياق صفرية.</td></tr>
<tr><td><b>يعمل في أي مكان، وليس على حاسوبك المحمول فقط</b></td><td>سبعة خلفيات طرفية — محلية، وDocker، وSSH، وSingularity، وModal، وDaytona، وVercel Sandbox. يوفّر Daytona وModal استمرارية بلا خوادم — فبيئة وكيلك تدخل في سبات عند الخمول وتستيقظ عند الطلب، بتكلفة لا تكاد تُذكر بين الجلسات. شغّله على خادم VPS بقيمة 5 دولارات أو على عنقود GPU.</td></tr>
<tr><td><b>جاهز للبحث</b></td><td>توليد مسارات على دفعات، وضغط المسارات لتدريب الجيل التالي من نماذج استدعاء الأدوات.</td></tr>
</table>
---
## تثبيت سريع
### Linux وmacOS وWSL2
```bash
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
```
### Windows (أصلي، PowerShell)
> **تنبيه:** يعمل Hermes على Windows الأصلي دون WSL — إذ تعمل واجهة سطر الأوامر والبوابة وواجهة TUI والأدوات جميعها بشكل أصلي. وإذا كنت تفضّل استخدام WSL2، فإن أمر Linux/macOS أحادي السطر أعلاه يعمل هناك أيضًا. هل وجدت خطأً؟ يُرجى [الإبلاغ عن المشكلات](https://github.com/NousResearch/hermes-agent/issues).
نفّذ هذا في PowerShell:
```powershell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
```
يقوم مثبّت المصدر بتفويض Python 3.14 وNode.js وnpm وripgrep وFFmpeg
وتبعيات Python إلى PM. إذا كان Git غائبًا، فإنه يجهّز أرشيف Git
for Windows المُتحقَّق منه في مخزن أدوات Hermes. وهو لا يستبدل Git الخاص بنظامك.
راجع [طرق التثبيت](https://hermes-agent.nousresearch.com/docs/getting-started/installation)
للاطلاع على حزمة MSIX/App Installer المنفصلة وملكية تحديثاتها.
> **Android / Termux:** يتوفر مستودع APT موقّع لأجهزة aarch64، مع قناة `stable` (الإصدارات الموسومة) وقناة `canary` التمهيدية. تتضمن الحزمة Python وNode.js وواجهة TUI. استخدم [دليل Termux](https://hermes-agent.nousresearch.com/docs/getting-started/termux)، وليس سكربت مثبّت سطح المكتب/الخادم.
>
> **Windows:** نظام Windows الأصلي مدعوم بالكامل — حيث يثبّت أمر PowerShell أحادي السطر أعلاه كل شيء. وإذا كنت تفضّل استخدام WSL2، فإن أمر Linux يعمل هناك أيضًا. يُثبَّت Windows الأصلي ضمن `%LOCALAPPDATA%\hermes`؛ بينما يُثبَّت WSL2 ضمن `~/.hermes` كما في Linux.
بعد التثبيت:
```bash
source ~/.bashrc # reload shell (or: source ~/.zshrc)
hermes # start chatting!
```
### استكشاف الأخطاء وإصلاحها
#### Windows Defender أو برامج مكافحة الفيروسات تُصنّف `uv.exe` كبرمجية خبيثة
إذا قام برنامج مكافحة الفيروسات لديك (Bitdefender، Windows Defender، إلخ) بعزل `uv.exe` من مجلد `bin` الخاص بـ Hermes (`%LOCALAPPDATA%\hermes\bin\uv.exe`)، فهذا **إنذار كاذب**. الملف هو `uv` من Astral — مدير حزم Python المكتوب بلغة Rust الذي يضمّنه Hermes لإدارة بيئة Python الخاصة به. غالبًا ما تُصنّف محركات مكافحة الفيروسات القائمة على التعلم الآلي الملفات التنفيذية غير الموقّعة المكتوبة بلغة Rust والتي تقوم بتنزيل الحزم وتثبيتها.
**للتحقق من أن نسختك أصلية:**
```powershell
# Install GitHub CLI if needed
winget install --id GitHub.cli
# Login to GitHub
gh auth login
# Run verification
$uv = "$env:LOCALAPPDATA\hermes\bin\uv.exe"
$ver = (& $uv --version).Split(' ')[1]
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$zip = "$env:TEMP\uv.zip"
Invoke-WebRequest "https://github.com/astral-sh/uv/releases/download/$ver/uv-x86_64-pc-windows-msvc.zip" -OutFile $zip -UseBasicParsing
gh attestation verify $zip --repo astral-sh/uv
Expand-Archive $zip "$env:TEMP\uv_x" -Force
(Get-FileHash "$env:TEMP\uv_x\uv.exe").Hash -eq (Get-FileHash $uv).Hash
```
إذا قال التحقق "Verification succeeded" وطبّع السطر الأخير `True`، فأنت بخير.
**لإضافة Hermes إلى القائمة البيضاء:**
- **Windows Defender:** شغّل PowerShell كمسؤول → `Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"`
- **Bitdefender:** أضف استثناءً في وحدة تحكم Bitdefender (Protection > Antivirus > Settings > Manage Exceptions)
- أضف **المجلد** إلى القائمة البيضاء، وليس تجزئة الملف — إذ يحدّث Hermes أداة `uv` وتتغير التجزئة مع كل إصدار
لمزيد من السياق، راجع تقارير Astral الأصلية: [astral-sh/uv#13553](https://github.com/astral-sh/uv/issues/13553)، [astral-sh/uv#15011](https://github.com/astral-sh/uv/issues/15011)، [astral-sh/uv#10079](https://github.com/astral-sh/uv/issues/10079).
---
## البدء
```bash
hermes # Interactive CLI — start a conversation
hermes model # Choose your LLM provider and model
hermes tools # Configure which tools are enabled
hermes config set # Set individual config values
hermes config get # Print individual config values
hermes gateway # Start the messaging gateway (Telegram, Discord, etc.)
hermes setup # Run the full setup wizard (configures everything at once)
hermes claw migrate # Migrate from OpenClaw (if coming from OpenClaw)
hermes update # Update to the latest version
hermes doctor # Diagnose any issues
```
📖 **[التوثيق الكامل →](https://hermes-agent.nousresearch.com/docs/)**
---
## تخطَّ جمع مفاتيح API — Nous Portal
يعمل Hermes مع أي مزوّد تريده — وهذا لن يتغيّر. لكن إن كنت تفضّل ألّا تجمع خمسة مفاتيح API منفصلة للنموذج، والبحث على الويب، وتوليد الصور، وتحويل النص إلى كلام، ومتصفح سحابي، فإن **[Nous Portal](https://portal.nousresearch.com)** يغطيها جميعًا ضمن اشتراك واحد:
- **أكثر من 300 نموذج** — اختر أيًّا منها باستخدام `/model <name>`
- **بوابة الأدوات** — البحث على الويب، وتوليد الصور (FAL)، وتحويل النص إلى كلام (OpenAI)، والمتصفح السحابي (Browser Use)، وكلها تُوجَّه عبر اشتراكك. دون حسابات إضافية.
أمر واحد من تثبيت جديد:
```bash
hermes setup --portal
```
هذا يسجّل دخولك عبر OAuth، ويضبط Nous كمزوّدك، ويُفعّل بوابة الأدوات. تحقّق مما هو مُهيّأ في أي وقت باستخدام `hermes portal info`. التفاصيل الكاملة في [صفحة توثيق بوابة الأدوات](https://hermes-agent.nousresearch.com/docs/user-guide/features/tool-gateway).
لا يزال بإمكانك إحضار مفاتيحك الخاصة لكل أداة متى شئت — فالبوابة تعمل لكل خادم خلفي على حدة، وليست كل شيء أو لا شيء.
---
## مرجع سريع: واجهة سطر الأوامر مقابل المراسلة
لدى Hermes نقطتا دخول: ابدأ واجهة الطرفية باستخدام `hermes`، أو شغّل البوابة وتحدّث إليها من Telegram أو Discord أو Slack أو WhatsApp أو Signal أو Email. بمجرد دخولك في محادثة، تُشارَك العديد من أوامر الشرطة المائلة عبر الواجهتين.
| الإجراء | واجهة سطر الأوامر | منصات المراسلة |
| ------------------------------ | --------------------------------------------- | -------------------------------------------------------------------------------- |
| بدء الدردشة | `hermes` | شغّل `hermes gateway setup` + `hermes gateway start`، ثم أرسل رسالة إلى البوت |
| بدء محادثة جديدة | `/new` أو `/reset` | `/new` أو `/reset` |
| تغيير النموذج | `/model [provider:model]` | `/model [provider:model]` |
| تعيين شخصية | `/personality [name]` | `/personality [name]` |
| إعادة المحاولة أو التراجع عن الدور الأخير | `/retry`، `/undo` | `/retry`، `/undo` |
| ضغط السياق / التحقق من الاستخدام | `/compress`، `/usage`، `/insights [--days N]` | `/compress`، `/usage`، `/insights [days]` |
| تصفح المهارات | `/skills` أو `/<skill-name>` | `/<skill-name>` |
| مقاطعة العمل الحالي | `Ctrl+C` أو إرسال رسالة جديدة | `/stop` أو إرسال رسالة جديدة |
| حالة خاصة بالمنصة | `/platforms` | `/status`، `/sethome` |
للاطلاع على قوائم الأوامر الكاملة، راجع [دليل واجهة سطر الأوامر](https://hermes-agent.nousresearch.com/docs/user-guide/cli) و[دليل بوابة المراسلة](https://hermes-agent.nousresearch.com/docs/user-guide/messaging).
---
## التوثيق
توجد جميع الوثائق على **[hermes-agent.nousresearch.com/docs](https://hermes-agent.nousresearch.com/docs/)**:
| القسم | ما يغطيه |
| --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| [البدء السريع](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart) | التثبيت ← الإعداد ← أول محادثة في دقيقتين |
| [استخدام CLI](https://hermes-agent.nousresearch.com/docs/user-guide/cli) | الأوامر، اختصارات لوحة المفاتيح، الشخصيات، الجلسات |
| [الإعدادات](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) | ملف الإعدادات، المزوّدون، النماذج، جميع الخيارات |
| [بوابة المراسلة](https://hermes-agent.nousresearch.com/docs/user-guide/messaging) | Telegram، Discord، Slack، WhatsApp، Signal، Home Assistant |
| [الأمان](https://hermes-agent.nousresearch.com/docs/user-guide/security) | الموافقة على الأوامر، اقتران الرسائل المباشرة، عزل الحاويات |
| [الأدوات ومجموعات الأدوات](https://hermes-agent.nousresearch.com/docs/user-guide/features/tools) | أكثر من 40 أداة، نظام مجموعات الأدوات، خلفيات الطرفية |
| [نظام المهارات](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) | الذاكرة الإجرائية، Skills Hub، إنشاء المهارات |
| [الذاكرة](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory) | الذاكرة الدائمة، ملفات تعريف المستخدم، أفضل الممارسات |
| [تكامل MCP](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp) | ربط أي خادم MCP لقدرات موسّعة |
| [جدولة Cron](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron) | المهام المجدولة مع التسليم عبر المنصات |
| [ملفات السياق](https://hermes-agent.nousresearch.com/docs/user-guide/features/context-files) | سياق المشروع الذي يشكّل كل محادثة |
| [البنية المعمارية](https://hermes-agent.nousresearch.com/docs/developer-guide/architecture) | بنية المشروع، حلقة الوكيل، الفئات الرئيسية |
| [المساهمة](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing) | إعداد التطوير، عملية PR، أسلوب الكود |
| [مرجع CLI](https://hermes-agent.nousresearch.com/docs/reference/cli-commands) | جميع الأوامر والعلامات |
| [متغيرات البيئة](https://hermes-agent.nousresearch.com/docs/reference/environment-variables) | مرجع كامل لمتغيرات البيئة |
---
## الانتقال من OpenClaw
إذا كنت قادمًا من OpenClaw، يمكن لـ Hermes استيراد إعداداتك وذكرياتك ومهاراتك ومفاتيح API تلقائيًا.
**أثناء الإعداد لأول مرة:** يكتشف معالج الإعداد (`hermes setup`) مجلد `~/.openclaw` تلقائيًا ويعرض الترحيل قبل بدء الإعدادات.
**في أي وقت بعد التثبيت:**
```bash
hermes claw migrate # Interactive migration (full preset)
hermes claw migrate --dry-run # Preview what would be migrated
hermes claw migrate --preset user-data # Migrate without secrets
hermes claw migrate --overwrite # Overwrite existing conflicts
```
ما الذي يتم استيراده:
- **SOUL.md** — ملف الشخصية
- **الذكريات** — إدخالات MEMORY.md وUSER.md
- **المهارات** — المهارات التي أنشأها المستخدم → `~/.hermes/skills/openclaw-imports/`
- **قائمة الأوامر المسموح بها** — أنماط الموافقة
- **إعدادات المراسلة** — إعدادات المنصات، والمستخدمون المسموح لهم، ودليل العمل
- **مفاتيح API** — الأسرار المدرجة في القائمة المسموح بها (Telegram، OpenRouter، OpenAI، Anthropic، ElevenLabs)
- **أصول TTS** — ملفات الصوت في مساحة العمل
- **تعليمات مساحة العمل** — AGENTS.md (مع `--workspace-target`)
راجع `hermes claw migrate --help` لجميع الخيارات، أو استخدم مهارة `openclaw-migration` لترحيل تفاعلي موجّه بواسطة الوكيل مع معاينات تجريبية.
---
## المساهمة
نرحّب بمساهماتكم! راجع [دليل المساهمة](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing) للاطلاع على إعداد التطوير، وأسلوب الكود، وعملية طلبات السحب (PR).
ابدأ بـ [سير عمل مطوّر PM](https://github.com/nousresearch/hermes-agent/blob/main/website/docs/reference/package-management.md#developer-workflow)
للاطلاع على التفعيل، والاستخدام اليومي، وتغييرات التبعيات، ومغادرة البيئة.
يغطي [إعداد التطوير](https://github.com/nousresearch/hermes-agent/blob/main/CONTRIBUTING.md#development-setup) بيئة الاختبار المنفصلة وأوامر التحقق.
---
## المجتمع
- 💬 [Discord](https://discord.gg/NousResearch)
- 📚 [Skills Hub](https://agentskills.io)
- 🐛 [Issues](https://github.com/NousResearch/hermes-agent/issues)
- 🔌 [computer-use-linux](https://github.com/avifenesh/computer-use-linux) — خادم MCP للتحكم بسطح مكتب Linux من أجل Hermes وغيره من مضيفي MCP، مع أشجار إمكانية الوصول AT-SPI، وإدخال Wayland/X11، ولقطات الشاشة، واستهداف نوافذ مدير التركيب.
- 🔌 [HermesClaw](https://github.com/AaronWong1999/hermesclaw) — جسر WeChat المجتمعي: شغّل Hermes Agent وOpenClaw على حساب WeChat نفسه.
---
## الترخيص
MIT — راجع [LICENSE](https://github.com/nousresearch/hermes-agent/blob/main/LICENSE).
من إنشاء [Nous Research](https://nousresearch.com).