Hermes Atlas: دليل تركيب خريطة أدوات Hermes Agent ونشرها على Vercel
🗺️ Hermes Atlas — the community map of every tool, skill, and integration for Hermes Agent by Nous Research. Live at hermesatlas.com
خريطة الصفحة
اختر القسم الذي تحتاجه الآن
- ما هو Hermes Atlas؟
- حالة استخدام: تخصيص الخريطة لأدوات عربية
- مقارنة: Hermes Atlas vs LangChain Hub
- المتطلبات الأساسية
- التركيب خطوة بخطوة (محلياً)
- شرح ملف .env والمتغيرات
- النشر على Vercel
- أخطاء شائعة وحلولها
- الخصوصية والأمان: أين تذهب بياناتك؟
- القيود
- الخلاصة
قبل أن تطبق
الفكرة التي تمنع التسرع
مطور سعودي يريد إضافة أدوات LLM عربية إلى خريطة Hermes Atlas، لكنه يواجه مشاكل في التثبيت والخصوصية. هذا الدليل يحل هذه المشاكل.
أسئلة التشخيص السريع
قبل أن تطبق، اعرف أين تقف بالضبط
- هل لديك حساب GitHub ومستودع جاهز لرفع المشروع؟
- هل حصلت على مفتاح GitHub API (GITHUB_TOKEN)؟
- هل حصلت على مفتاح OpenRouter API (OPENROUTER_API_KEY)؟
- هل جهازك مثبت عليه Node.js 18+ و Git؟
- هل جربت تشغيل المشروع محلياً بنجاح؟
- هل واجهت خطأ rate limit من GitHub API؟
- هل تحتاج إلى إضافة أدوات عربية مثل 'جليس' عبر Pull Request؟
نظام التشغيل: Input → Process → Output
لوحة قياس النجاح
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
مطور سعودي يريد بناء دليل لأدوات الذكاء الاصطناعي العربية باستخدام Hermes Atlas. يواجه مشكلة في تثبيت المشروع ونشره على Vercel. هذا الدليل يقدم حلاً عملياً خطوة بخطوة، مع شرح متغيرات البيئة، مقارنة مع بدائل مثل LangChain Hub، وحلول للأخطاء الشائعة. لا حاجة لخبرة عميقة، فقط معرفة أساسية بسطر الأوامر وGit.
ما هو Hermes Atlas؟
Hermes Atlas هو موقع ويب مفتوح المصدر يجمع أدوات ومهارات Hermes Agent في خريطة واحدة. يحتوي على أدوات مصنفة مع أعداد نجوم حية ورسوم بيانية. تم إطلاقه في أوائل 2026 (التاريخ الدقيق غير مؤكد).
حالة استخدام: تخصيص الخريطة لأدوات عربية
مطور سعودي يريد إضافة نماذج LLM عربية مثل 'جليس' أو أدوات معالجة لهجات خليجية. يمكنه استخدام Hermes Atlas لإنشاء دليل محلي، وإضافة أدوات عبر Pull Request على GitHub.
مقارنة: Hermes Atlas vs LangChain Hub
LangChain Hub هو بديل يقدم أدوات لـ LangChain، بينما Hermes Atlas مخصص لـ Hermes Agent. Hermes Atlas مجاني ومفتوح المصدر، بينما LangChain Hub قد يتطلب اشتراكاً لبعض الميزات. Hermes Atlas أسهل في التخصيص المحلي.
المتطلبات الأساسية
- حساب GitHub (للمساهمة أو API token)
- حساب Vercel (مجاني كافٍ)
- مفتاح OpenRouter API (مجاني مع حد استخدام)
- Node.js 18+ على جهازك
- Git
التركيب خطوة بخطوة (محلياً)
- افتح الطرفية ونفذ:
git clone https://GitHub.com/ksimback/hermes-ecosystem.git cd hermes-ecosystemnpm install- أنشئ ملف
.envمن النموذج أدناه - شغّل المشروع محلياً:
npm run dev - افتح المتصفح على
http://localhost:3000
شرح ملف .env والمتغيرات
إليك نموذج ملف .env كامل مع قيم افتراضية:
# مفتاح GitHub API (مطلوب لزيادة حد الطلبات)
GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx
# مفتاح OpenRouter API (مطلوب لبعض الوظائف)
OPENROUTER_API_KEY=sk-or-xxxxxxxxxxxxxxxxxxxx
# اختياري: إعدادات Redis (إذا كنت تستخدم Redis محلياً)
REDIS_URL=redis://localhost:6379GITHUB_TOKEN يمكن الحصول عليه من GitHub Settings > Developer settings > Personal access tokens > Fine-grained tokens. امنحه صلاحية قراءة عامة فقط.
النشر على Vercel
- ارفع المشروع إلى مستودع GitHub خاص أو عام.
- ادخل إلى Vercel، اضغط Add New > Project، واختر المستودع.
- أضف المتغيرات البيئية: GITHUB_TOKEN و OPENROUTER_API_KEY.
- اضغط Deploy. سيكتشف Vercel الإعدادات من vercel.json.
- بعد النشر، الموقع متاح على رابط مثل your-project.vercel.app.
أخطاء شائعة وحلولها
الخصوصية والأمان: أين تذهب بياناتك؟
Hermes Atlas لا يخزن بيانات المستخدمين. يستخدم GitHub API و OpenRouter API، وكلاهما يتطلب مفاتيح API. البيانات المرسلة إلى OpenRouter قد تخضع لسياسة الخصوصية الخاصة به. لا يستخدم كوكنيز للتتبع. يوصى بعدم مشاركة مفاتيح API الحساسة.
القيود
- الواجهة باللغة الإنجليزية حالياً، لا يدعم اللغة العربية بشكل أصلي.
- يعتمد على خدمات خارجية (Vercel, OpenRouter, GitHub) قد تتعطل.
- عدد الأدوات محدود بما هو موجود في المستودع.
الخلاصة
Hermes Atlas أداة مفيدة لمطوري Hermes Agent، سهلة التركيب والنشر. مناسبة للمطورين السعوديين الراغبين في تخصيص خريطة أدوات عربية. العيب الرئيسي هو عدم دعم العربية والاعتماد على خدمات خارجية.
Playbook التطبيق
خطوات عملية مرتبة من التشخيص إلى النتيجة
استنساخ المستودع
لماذا؟ للحصول على الكود المصدري لـ Hermes Atlas محلياً.
كيف؟ نفذ الأمر: git clone https://github.com/ksimback/hermes-ecosystem.git ثم cd hermes-ecosystem
الناتج: مجلد hermes-ecosystem على جهازك.
تثبيت الاعتماديات
لماذا؟ لتثبيت المكتبات اللازمة لتشغيل المشروع.
كيف؟ نفذ: npm install
الناتج: تثبيت جميع الحزم في node_modules.
إعداد ملف .env
لماذا؟ لتوفير مفاتيح API اللازمة للتشغيل.
كيف؟ أنشئ ملف .env بالمحتوى التالي: GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx OPENROUTER_API_KEY=sk-or-xxxxxxxxxxxxxxxxxxxx REDIS_URL=redis://localhost:6379
الناتج: ملف .env جاهز.
تشغيل المشروع محلياً
لماذا؟ للتأكد من أن كل شيء يعمل قبل النشر.
كيف؟ نفذ: npm run dev ثم افتح http://localhost:3000
الناتج: المشروع يعمل محلياً.
رفع المشروع إلى GitHub
لماذا؟ لربطه مع Vercel للنشر.
كيف؟ أنشئ مستودعاً على GitHub، ثم ادفع الكود: git remote add origin <url> && git push -u origin main
الناتج: المستودع على GitHub.
النشر على Vercel
لماذا؟ لجعل الموقع متاحاً على الإنترنت.
كيف؟ في Vercel، أضف مشروعاً جديداً، اختر المستودع، أضف المتغيرات البيئية GITHUB_TOKEN و OPENROUTER_API_KEY، ثم انشر.
الناتج: رابط مثل your-project.vercel.app.
قوالب جاهزة للنسخ
حوّل القراءة إلى تنفيذ سريع
GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx OPENROUTER_API_KEY=sk-or-xxxxxxxxxxxxxxxxxxxx REDIS_URL=redis://localhost:6379
## ملخص إضافة أداة [اسم الأداة] لمعالجة اللهجات الخليجية. ## التغييرات - إضافة ملف الأداة في `tools/` - تحديث `tools.json` ## اختبار - تأكد من ظهور الأداة في الخريطة - تحقق من عدد النجوم
مصفوفة الأخطاء
اعرف أين يتعثر الناس وكيف تتجنب ذلك
شجرة القرار
ماذا تفعل حسب حالتك؟
إذا: إذا واجهت rate limit من GitHub API
إذن: أضف GITHUB_TOKEN في متغيرات البيئة.
إذا: إذا لم يعمل OpenRouter
إذن: تحقق من OPENROUTER_API_KEY وأضفه.
إذا: إذا فشل البناء على Vercel
إذن: اضبط إصدار Node.js إلى 18.
إذا: إذا أردت إضافة أداة عربية
إذن: أنشئ Pull Request على GitHub.
خطة تطبيق 7 أيام
جدول صغير يمنع التسويف
- اليوم 1: استنساخ المستودع وتثبيت الاعتماديات
- اليوم 2: إعداد ملف .env وتشغيل المشروع محلياً
- اليوم 3: رفع المشروع إلى GitHub
- اليوم 4: النشر على Vercel واختبار الرابط
- اليوم 5: إضافة أداة عربية عبر Pull Request
- اليوم 6: اختبار الأداة الجديدة وحل المشكلات
- اليوم 7: توثيق التجربة ومشاركتها
حقائق سريعة تحفظها
نقاط مختصرة ترجع لها لاحقاً
1. Hermes Atlas مفتوح المصدر ومجاني.
2. يتطلب Node.js 18+ و Git.
3. يحتاج إلى مفتاح GitHub API و OpenRouter API.
4. يمكن نشره على Vercel مجاناً.
5. لا يدعم اللغة العربية بشكل أصلي.
6. يمكن تخصيصه عبر Pull Request.
7. عدد الأدوات محدود بالمستودع.
8. لا يخزن بيانات المستخدمين.
9. يعتمد على خدمات خارجية قد تتعطل.
أسئلة شائعة
إجابات مباشرة على ما يبحث عنه الزائر
مصطلحات سريعة
تعريفات مختصرة تمنع الالتباس
موقع ويب مفتوح المصدر يعرض خريطة لأدوات ومهارات Hermes Agent مع أعداد نجوم حية.
إطار عمل لتطوير وكلاء ذكاء اصطناعي.
خدمة توفر واجهة برمجية للوصول إلى نماذج LLM متعددة.
منصة استضافة سحابية لتطبيقات الويب، تدعم النشر التلقائي من GitHub.
أسئلة مرتبطة يبحث عنها الناس
استخدمها كمسارات متابعة داخل نفس الموضوع
لماذا هذا المرجع يتجاوز الموضوع نفسه؟
تحول القارئ: من مطور يبحث عن دليل عربي لتركيب Hermes Atlas إلى مستخدم قادر على نشره وتخصيصه واستخدامه لاكتشاف أدوات AI
- إدارة المشاريع: يمكن استخدام Hermes Atlas كمرجع لأدوات الأتمتة
- التسويق: يمكن تخصيص الخريطة لعرض أدوات شركة ناشئة
- التعليم: يمكن استخدامها في ورش عمل عن وكلاء AI
كيف تستخدم هذا المرجع لاحقاً؟
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
Hermes Atlas أداة قوية لمطوري Hermes Agent. باتباع هذا الدليل، يمكنك تركيبها ونشرها بسهولة. ابدأ الآن واستفد من الخريطة لبناء أدوات عربية.
خطة تحديث هذا الدليل
حتى يبقى المرجع صالحاً مع الوقت
- تحديث مفاتيح API كل 6 أشهر أو عند انتهاء صلاحيتها.
- مزامنة المستودع مع upstream كل شهر للحصول على التحديثات.
- مراجعة قائمة الأدوات المضافة شهرياً.
التعليقات (0)
لا توجد تعليقات بعد. كن أول من يبدأ النقاش 👇