Hermes ን መጫን እና OmniProxy ን ማዋቀር

Hermes ንግግሮችን እና የስራ ልምድን ሊይዝ የሚችል ረዳት ነው፣ የተጠናቀቀ ስራን በኋላ እንደገና ጥቅም ላይ ሊውሉ የሚችሉ ክህሎቶች ይለውጣል። በአንድ ጌትዌይ በኩል፣ ከTelegram፣ Discord፣ Slack፣ WhatsApp፣ Signal እና ተርሚናል ጋር መገናኘት ይችላል። ጌትዌይ መልዕክቶችን ለመቀበል እና ለማስተላለፍ እንደ የተዋሃደ የመግቢያ ነጥብ ሆኖ ያገለግላል። ከወትሮው የውይይት መሳሪያዎችዎ የኮድ ግምገማዎችን፣ የክስተት ማስታወሻዎችን ወይም የደንበኛ ቁሳቁሶችን መላክ ይችላሉ፣ ከዚያ ወደ ማጠራቀሚያው እንዲመለስ እና መስራቱን እንዲቀጥል ማድረግ ይችላሉ።

ከመጀመርዎ በፊት

በመጀመሪያ፣ በኮምፒውተርዎ ኦፕሬቲንግ ሲስተም ላይ በመመስረት የመጫኛ ዘዴ ይምረጡ። macOS እና Windows በቀጥታ ግራፊክ ጫኚዎችን መጠቀም ይችላሉ፣ Linux፣ macOS እና WSL2 ደግሞ የተርሚናል ስክሪፕት መጠቀም ይችላሉ። WSL2 የLinux አካባቢን ለማስኬድ የWindows ባህሪ ነው። በአንድሮይድ ስልኮች ላይ Termux እና Docker የራሳቸው የመጫኛ ዘዴዎች አሏቸው፣ ነገር ግን ይህ መመሪያ በመደበኛ ኮምፒውተሮች ላይ መጫንን ብቻ ይሸፍናል።

መስኮት ይፈልጋሉ

macOS, Windows

• macOS: DMG ን ይክፈቱ
• Windows: ጫኚውን ይክፈቱ
• መተግበሪያውን በስርዓቱ ላይ ይጫኑ

ተርሚናል ብቻ

Linux, macOS, WSL2

• አንድ install.sh ትዕዛዝ
• በWindows ላይ install.ps1 ይጠቀሙ
• ከተጫነ በኋላ hermes ያስገቡ

እነዚህን ገና አይጠቀሙ

pip, brew, AUR

• እነዚህ የመጫኛ ዘዴዎች በይፋ አይደገፉም
• ከተጫኑ በኋላ ለማዘመን አስቸጋሪ ናቸው
• በግራ በኩል ካሉት ሁለት አማራጮች አንዱን ይጠቀሙ

ከመጀመርዎ በፊት፣ macOS፣ Windows ወይም Linux ኮምፒውተር ያዘጋጁ እና ተርሚናል መክፈት እና GitHub መድረስ መቻሉን ያረጋግጡ። Hermes ን በውጫዊ ድራይቭ ላይ ለመጫን ካሰቡ፣ ድራይቭን መጀመሪያ ያገናኙ እና በቂ ነፃ ቦታ እንዳለው ያረጋግጡ።

ለመጀመሪያ ጊዜ መጫን እና ማስጀመር

ግራፊክ መተግበሪያ ከፈለጉ

ወደ በHermes ድረ-ገጽ ላይ ያለው የማውረጃ ክፍል ይሂዱ እና ለኦፕሬቲንግ ሲስተምዎ ጫኚውን ያውርዱ። ጫኚው ቀድሞውኑ የሩጫ አካባቢውን ያካትታል፣ ስለዚህ ለመጀመሪያ ጊዜ ሲከፍቱት በአካባቢው ምንም ነገር መገንባት አያስፈልግም።

• macOS: DMG ን ይክፈቱ እና ይውሰዱ Hermes.app ወደ Applications። DMG በmacOS ላይ በብዛት ጥቅም ላይ የሚውል የመጫኛ ምስል ነው። ይህ ጫኚ Apple silicon ብቻ ይደግፋል; Intel Macs አይደገፉም።
• Windows: ይክፈቱ .appinstaller ፋይል በWindows App Installer። በWindows ጥቅም ላይ የሚውል የመተግበሪያ ጥቅል አይነት የሆነ የተፈረመ MSIX ይጭናል።
• Linux: የዴስክቶፕ ጫኚዎች ለmacOS እና Windows ናቸው። በLinux ላይ፣ ከታች ያለውን የተርሚናል ትዕዛዝ ይጠቀሙ። ከተጫነ በኋላ፣ ማሄድ ይችላሉ hermes desktop.

ተርሚናል ብቻ ከፈለጉ

Linux፣ macOS ወይም WSL2 የሚጠቀሙ ከሆነ፣ በተርሚናል ውስጥ ይህንን ያሂዱ:

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

በWindows የተካተተውን PowerShell ሲጠቀሙ፣ ያሂዱ:

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 በቀጥታ ከGrok ወይም Gemini ይልቅ ከOmniProxy ጋር ይገናኛል። የGrok እና Gemini አገልግሎት አድራሻዎችን በOmniProxy ውስጥ ያዋቅሩ; በቀጥታ በHermes ውስጥ አያስገቡዋቸው።

ኮምፒውተርዎ

Hermes

→

የአካባቢ ጌትዌይ

OmniProxy

• በአድራሻው ውስጥ /v1 ያካትቱ

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

የሞዴል መታወቂያ API ሞዴልን ለመለየት የሚጠቀምበት ትክክለኛ ስም ነው። ለሁለቱ ሞዴሎች የሚከተሉትን ስሞች ይጠቀሙ:

• ለGrok፣ ያስገቡ grok-4.7። የxAI API ነው https://api.x.ai/v1፣ እና የውይይት ጥያቄዎች ይጠቀማሉ /v1/chat/completions። ይመልከቱ Grok model documentation።
• ለGemini፣ ያስገቡ gemini-3.8-flash። የGoogle OpenAI-ተኳሃኝ API ነው https://generativelanguage.googleapis.com/v1beta/openai/። ይመልከቱ Gemini’s OpenAI compatibility documentation።

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 አስቀድሞ የተዘጋጀ አቅራቢ ከመጠቀም ይልቅ እርስዎ የሚገልጹትን የአገልግሎት አድራሻ ያገናኛል ማለት ነው።

የማዋቀሪያው አዋቂ (setup wizard) የመድረሻ ነጥብ URL፣ ቁልፍ እና የሞዴል ስም በቅደም ተከተል ይጠይቃል። ከቀዳሚው ክፍል ሶስቱን እሴቶች ያስገቡ። Gemini ን ለመጠቀም፣ ያስገቡ gemini-3.8-flash እንደ የሞዴል ስም

ማርትዕም ይችላሉ ~/.hermes/config.yaml በቀጥታ። YAML የውቅር ግንኙነቶችን ለመወከል ውስጠ-ገብ (indentation) የሚጠቀም የጽሑፍ ቅርጸት ነው። የሚከተለው ውቅር 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 installation documentation እና platform support። ለብጁ መድረሻ ነጥብ ውቅር፣ ይመልከቱ Hermes Provider documentation። ለሞዴል መታወቂያዎች፣ ይመልከቱ Grok model documentation እና Gemini’s OpenAI compatibility documentation。

የmacOS መጫኛ ሂደት የተጠናቀቀው እ.ኤ.አ. በ2026-10-09 በHermes Agent v0.21.6 ነው። grok-4.7 እና gemini-3.8-flash በዚያ ቀን በxAI እና Google ሰነድ ውስጥ መደበኛ የሞዴል መታወቂያዎች ነበሩ። እሴቶቹን ሲያስገቡ፣ በOmniProxy ውስጥ የሚታዩትን ስሞች ይጠቀሙ。

እያንዳንዱን የቦታ ያዥ (placeholder) በራስዎ የ OmniProxy ውቅር እሴቶች ይተኩ። እውነተኛ ቁልፍን በጭራሽ አያትሙ።

የተቀመጠ ውጤት ወይም HTTP 200 ብቻውን ሙሉ የAgent ተኳኋኝነትን አያረጋግጥም። በ OmniProxy የጥያቄ መዝገብ ውስጥ ምንጩን እና ሞዴሉን ያረጋግጡ።

ኦፊሴላዊ ምንጮች · Hermes ↗