התקנת Hermes והגדרת OmniProxy

Hermes הוא עוזר שיכול לשמור שיחות וניסיון במשימות, ולהפוך עבודה שהושלמה למיומנויות שניתן לעשות בהן שימוש חוזר מאוחר יותר. דרך Gateway יחיד, הוא יכול גם להתחבר ל-Telegram, Discord, Slack, WhatsApp, Signal ולטרמינל. ה-Gateway משמש כנקודת כניסה מאוחדת לקבלת והעברת הודעות. אתה יכול לשלוח לו ביקורות קוד, הערות על אירועים או חומרים של לקוחות מכלי הצ’אט הרגילים שלך, ולאחר מכן לבקש ממנו לחזור למאגר ולהמשיך לעבוד.

לפני שמתחילים

ראשית, בחר שיטת התקנה בהתבסס על מערכת ההפעלה של המחשב שלך. macOS ו-Windows יכולים להשתמש במתקינים גרפיים ישירות, בעוד ש-Linux, macOS ו-WSL2 יכולים להשתמש בסקריפט טרמינל. WSL2 הוא תכונה של Windows להרצת סביבת Linux. ל-Termux בטלפונים אנדרואיד ול-Docker יש שיטות התקנה משלהם, אך מדריך זה מכסה רק התקנה על מחשבים רגילים.

רוצה חלון

macOS, Windows

• macOS: פתח את ה-DMG
• Windows: פתח את המתקין
• התקן את האפליקציה על המערכת

טרמינל בלבד

Linux, macOS, WSL2

• פקודת install.sh אחת
• השתמש ב-install.ps1 ב-Windows
• הזן hermes לאחר ההתקנה

אל תשתמש באלו עדיין

pip, brew, AUR

• שיטות התקנה אלו אינן נתמכות רשמית
• הן גם קשות לעדכון לאחר ההתקנה
• השתמש באחת משתי האפשרויות משמאל במקום

לפני שמתחילים, הכן מחשב macOS, Windows או Linux וודא שהוא יכול לפתוח טרמינל ולגשת ל-GitHub. אם אתה מתכנן להתקין את Hermes על כונן חיצוני, חבר את הכונן תחילה ואשר שיש בו מספיק שטח פנוי.

התקנה והפעלה ראשונה

אם ברצונך באפליקציה גרפית

עבור ל-סעיף ההורדות באתר Hermes והורד את המתקין עבור מערכת ההפעלה שלך. המתקין כבר כולל את סביבת ההרצה, כך שאין צורך לקמפל דבר מקומית כאשר פותחים אותו בפעם הראשונה.

• macOS: פתח את ה-DMG והעבר את Hermes.app לתוך Applications. DMG הוא תמונת התקנה הנפוצה ב-macOS. מתקין זה תומך ב-Apple silicon בלבד; מחשבי Intel Mac אינם נתמכים.
• Windows: פתח את קובץ ה- .appinstaller עם Windows App Installer. הוא מתקין MSIX חתום, סוג של חבילת יישום המשמשת את Windows.
• Linux: המתקינים השולחניים הם עבור macOS ו-Windows. ב-Linux, השתמש בפקודת הטרמינל למטה. לאחר ההתקנה, ניתן להריץ את hermes desktop.

אם אתה זקוק רק לטרמינל

אם אתה משתמש ב-Linux, macOS או WSL2, הרץ זאת בטרמינל:

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

בעת שימוש ב-PowerShell הכלול ב-Windows, הרץ:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

המתקין מוריד את קוד Hermes ואת התוכניות הנדרשות להרצתו. אם ההורדה מופסקת, הרץ את אותה פקודה שוב. לאחר סיום ההתקנה, סגור את הטרמינל הנוכחי, פתח חלון חדש והזן:

hermes

אם אתה רואה את ההנחיה של Hermes, הפקודה מוכנה לשימוש. לאחר מכן ניתן להריץ את hermes doctor; בדיקת התקנה זו אומרת לך מה עדיין חסר.

אחסון התוכנית בכונן חיצוני

ב-9 באוקטובר 2026, Hermes Agent v0.21.6 הותקן על כונן חיצוני המחובר ל-Mac. התוכנית אוחסנה ב- /Volumes/AItools/tools/hermes-agent, פקודת המפעיל מוקמה ב- ~/.local/bin/hermes, ונתוני ההגדרות והשיחות נשארו ב- ~/.hermes.

אם לכונן שלך יש שם אחר, החלף את הנתיב אחרי --dir בתיקייה שלך. הכונן חייב להישאר מחובר בזמן ש-Hermes פועל.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh -o install.sh
bash install.sh --dir /Volumes/AItools/tools/hermes-agent --non-interactive

תוכנית

כונן חיצוני

• tools/hermes-agent
• שמור את הקוד כאן

פקודה

~/.local/bin/hermes

• הזן hermes בטרמינל
• זה נכנס לתוקף לאחר פתיחת חלון חדש

הגדרות וצ'אטים

~/.hermes

• config.yaml נמצא כאן
• צא לפני ניתוק הכונן

קבלת ערכי חיבור מ-OmniProxy

כאן, Hermes מתחבר ל-OmniProxy במקום ישירות ל-Grok או Gemini. הגדר את כתובות ה-URL של שירותי Grok ו-Gemini ב-OmniProxy; אל תזין אותן ישירות ב-Hermes.

המחשב שלך

Hermes

→

Gateway מקומי

OmniProxy

• כלול את /v1 בכתובת

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

מזהה מודל הוא השם המדויק שה-API משתמש בו כדי לזהות מודל. השתמש בשמות הבאים עבור שני המודלים:

• עבור Grok, הזן את grok-4.7. ה-API של xAI הוא https://api.x.ai/v1, ובקשות צ’אט משתמשות ב- /v1/chat/completions. ראה את תיעוד מודל Grok.
• עבור Gemini, הזן את gemini-3.8-flash. ה-API התואם ל-OpenAI של Google הוא https://generativelanguage.googleapis.com/v1beta/openai/. ראה תיעוד תאימות OpenAI של Gemini.

כדי להעביר את Hermes ל-Gemini, שנה רק את שם המודל ל- gemini-3.8-flash. המשך להשתמש בכתובת OmniProxy כנקודת הקצה של ה-API.

העתק את כתובת ה-URL של נקודת הקצה והמפתח מ-OmniProxy, ולאחר מכן הזן את מזהה המודל המתאים:

Base URL: https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: grok-4.7

Base URL היא נקודת הקצה שאליה Hermes שולח בקשות. היא חייבת להסתיים ב- /v1 כאן. API Key הוא המפתח ש-OmniProxy מנפיק ל-Hermes. החלף את מציין המקום בערך שלך, ואל תפרסם אותו בדף ציבורי.

אם מופע ה-OmniProxy המקומי שלך אינו דורש מפתח, ניתן להשאיר את API Key ריק. אם הכתובת נגישה לכל אחד אחר, עליך להשתמש במפתח. אשר גם שהכתובת ניתנת להגעה מהסביבה שבה Hermes פועל. אם Hermes ו-OmniProxy נמצאים על אותו מחשב, ניתן להשתמש בכתובת מקומית.

הזנת הגדרות הכלי

ראשית, צא מהצ’אט הנוכחי, ולאחר מכן הרץ זאת בטרמינל:

hermes model

בחר Custom endpoint (self-hosted / VLLM / etc.). נקודת קצה מותאמת אישית אומרת ש-Hermes מתחבר לכתובת שירות שאתה מציין במקום להשתמש בספק מוגדר מראש.

אשף ההגדרה מבקש את כתובת נקודת הקצה, המפתח ושם המודל ברצף. הזן את שלושת הערכים מהסעיף הקודם. כדי להשתמש ב-Gemini, הזן את gemini-3.8-flash כשם המודל.

ניתן גם לערוך את ~/.hermes/config.yaml ישירות. YAML הוא פורמט טקסט המשתמש בהזחה כדי לייצג קשרי הגדרות. ההגדרה הבאה משתמשת ב-Grok:

model:
  default: grok-4.7
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

כדי להשתמש ב-Gemini, שנה את default ל- gemini-3.8-flash והשאר את שלושת הערכים האחרים ללא שינוי:

model:
  default: gemini-3.8-flash
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

לאחר השמירה, הרץ את hermes שוב והתחל צ’אט חדש. בסשן שכבר פתוח, /model יכול לעבור רק בין ספקים שכבר נשמרו; הוא לא יכול להוסיף הגדרה זו.

אימות עם משימה אמיתית

1

hermes doctor

• בדיקת התקנה עוברת

2

שלח הודעה קצרה

• ראה תשובה מ-Hermes

3

פתח את יומני הבקשות

• אמת את שם המודל

1. הרץ את hermes doctor כדי לבדוק אם ההתקנה הושלמה.
2. הרץ את hermes ובקש ממנו להסביר במשפט אחד מה הוא יכול לעשות. אתה אמור לראות תגובה.
3. פתח את יומן הבקשות של OmniProxy, אשר שהבקשה הגיעה מ-Hermes, ובדוק אם שם המודל הוא grok-4.7 או gemini-3.8-flash.

לראות שאשף ההגדרה נשמר בהצלחה, או שה-API החזיר תגובה מוצלחת, זה לא מספיק כדי להראות ש-Hermes יכול להשלים עבורך משימות. שם המודל ביומן הבקשות חייב להתאים לערך שהזנת.

כדי לצ’וטט בדפדפן, הרץ את הפקודה הבאה מקומית:

hermes dashboard --no-open --host 127.0.0.1 --port 9119

לאחר מכן פתח את http://127.0.0.1:9119. כתובת זו עובדת רק במחשב הנוכחי.

שגיאות נפוצות

• הזנת hermes מדווחת שלא ניתן למצוא את הפקודה: סגור את הטרמינל ופתח חלון חדש. אם הפקודה עדיין לא נמצאה, אשר ש- ~/.local/bin נמצא ב-PATH. PATH הוא רשימת הספריות שבהן המערכת מחפשת פקודות. ב-Windows, אשר שספריית ההפעלה שנוספה על ידי המתקין נמצאת ב-PATH.
• הורדת ההתקנה נעצרת באמצע: הרץ את אותה פקודת התקנה שוב. החלקים שכבר הורדו יהיו בשימוש חוזר.
• Hermes לא מגיב או מדווח שהוא לא יכול להתחבר: אשר ש-OmniProxy פועל ובדוק ש-Base URL מסתיים ב- /v1. אם Hermes רץ ב-Docker בזמן ש-OmniProxy רץ על המארח, אל תשתמש ב- 127.0.0.1 אם הוא תקף רק בתוך הקונטיינר.
• מופיעה שגיאת מפתח: עדכן את מפתח ה-OmniProxy, ולאחר מכן שנה את api_key ב- config.yaml. המפתח של xAI או Google שייך להגדרות הספק של OmniProxy; אל תזין אותו בשדה זה של Hermes.
• המודל מדווח כלא זמין: פתח את רשימת המודלים הנוכחית ב-OmniProxy והעתק את grok-4.7 או gemini-3.8-flash בדיוק כפי שהוא מופיע ברשימה.
• Hermes מגיב אך לא יכול לבצע משימות כגון קריאת קבצים או הרצת פקודות: עבור למודל אחר ב-OmniProxy שיש לו את היכולות הללו, ולאחר מכן התחל סשן Hermes חדש.
• התוכנית נמצאת על כונן חיצוני, ו- hermes doctor מדווח על שגיאת אחסון לאחר ניתוק הכונן: חבר את הכונן תחילה. אל תיתן ל-Hermes ליצור הגדרה נפרדת בזמן שהכונן מנותק.

הפניות

לשלבי התקנה, ראה את תיעוד התקנת Hermes ו-תמיכה בפלטפורמות. עבור הגדרת נקודת קצה מותאמת אישית, ראה את תיעוד הספק של Hermes. עבור מזהי המודל, ראה את תיעוד מודל Grok ו-תיעוד תאימות OpenAI של Gemini.

תהליך ההתקנה ב-macOS הושלם ב-9 באוקטובר 2026 באמצעות Hermes Agent v0.21.6. grok-4.7 ו- gemini-3.8-flash היו מזהי המודל הסטנדרטיים בתיעוד של xAI ו-Google באותו תאריך. בעת הזנת הערכים, השתמש בשמות המוצגים ב-OmniProxy.

החלף כל מקום לשימוש בערכים מההגדרה שלך ב-OmniProxy. לעולם לא פרסם מפתח אמיתי.

תוצאה שמורה או HTTP 200 בלבד אינם מוכיחים תאימות מלאה של הסוכן. בדוק את המקור והמודל ברשומת הקריאה של OmniProxy.

מקורות רשמיים · Hermes ↗