Hermes کی تنصیب اور OmniProxy کی کنفیگریشن

Hermes ایک اسسٹنٹ ہے جو بات چیت اور کام کے تجربے کو برقرار رکھ سکتا ہے، مکمل شدہ کام کو ایسی مہارتوں میں تبدیل کر سکتا ہے جنہیں بعد میں دوبارہ استعمال کیا جا سکتا ہے۔ ایک ہی گیٹ وے کے ذریعے، یہ ٹیلیگرام، ڈسکارڈ، سلیک، واٹس ایپ، سگنل، اور ٹرمینل سے بھی جڑ سکتا ہے۔ گیٹ وے پیغامات وصول کرنے اور آگے بھیجنے کے لیے ایک متحد انٹری پوائنٹ کے طور پر کام کرتا ہے۔ آپ اسے اپنے معمول کے چیٹ ٹولز سے کوڈ ریویوز، واقعاتی نوٹس، یا کسٹمر میٹریل بھیج سکتے ہیں، پھر اسے ریپوزٹری میں واپس لا کر کام جاری رکھ سکتے ہیں۔

شروع کرنے سے پہلے

سب سے پہلے، اپنے کمپیوٹر کے آپریٹنگ سسٹم کی بنیاد پر تنصیب کا طریقہ منتخب کریں۔ macOS اور Windows براہ راست گرافیکل انسٹالرز استعمال کر سکتے ہیں، جبکہ Linux، macOS، اور WSL2 ٹرمینل اسکرپٹ استعمال کر سکتے ہیں۔ WSL2 ایک Linux ماحول چلانے کے لیے Windows کی ایک خصوصیت ہے۔ Android فونز پر 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 سلیکون کو سپورٹ کرتا ہے؛ انٹیل Macs معاون نہیں ہیں۔
• Windows: Windows App Installer کے ساتھ .appinstaller فائل کھولیں۔ یہ ایک دستخط شدہ MSIX انسٹال کرتا ہے، جو Windows کے ذریعے استعمال ہونے والا ایک ایپلی کیشن پیکیج ہے۔
• 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 سے جڑتا ہے۔ OmniProxy میں Grok اور Gemini سروس URLs کنفیگر کریں؛ انہیں براہ راست Hermes میں درج نہ کریں۔

آپ کا کمپیوٹر

Hermes

→

مقامی گیٹ وے

OmniProxy

• ایڈریس میں /v1 شامل کریں

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

ماڈل ID وہ درست نام ہے جو API کسی ماڈل کی شناخت کے لیے استعمال کرتا ہے۔ دو ماڈلز کے لیے درج ذیل نام استعمال کریں:

• Grok کے لیے، grok-4.7 درج کریں۔ xAI API https://api.x.ai/v1 ہے، اور چیٹ کی درخواستیں /v1/chat/completions استعمال کرتی ہیں۔ Grok ماڈل دستاویزات دیکھیں۔
• Gemini کے لیے، gemini-3.8-flash درج کریں۔ Google کا OpenAI-مطابقت پذیر API https://generativelanguage.googleapis.com/v1beta/openai/ ہے۔ Gemini کی OpenAI مطابقت دستاویزات دیکھیں۔

Hermes کو Gemini پر سوئچ کرنے کے لیے، صرف ماڈل کا نام gemini-3.8-flash میں تبدیل کریں۔ OmniProxy ایڈریس کو API اینڈ پوائنٹ کے طور پر استعمال کرنا جاری رکھیں۔

OmniProxy سے اینڈ پوائنٹ URL اور کلید کاپی کریں، پھر متعلقہ ماڈل ID درج کریں:

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

بیس URL وہ اینڈ پوائنٹ ہے جہاں Hermes درخواستیں بھیجتا ہے۔ یہاں اس کا اختتام /v1 پر ہونا چاہیے۔ API کلید وہ کلید ہے جو OmniProxy Hermes کو جاری کرتا ہے۔ پلیس ہولڈر کو اپنی قدر کے ساتھ تبدیل کریں، اور اسے عوامی صفحہ پر شائع نہ کریں۔

اگر آپ کا مقامی OmniProxy انسٹنس کلید کا مطالبہ نہیں کرتا ہے، تو آپ API کلید کو خالی چھوڑ سکتے ہیں۔ اگر ایڈریس کسی اور کے لیے قابل رسائی ہے، تو آپ کو کلید استعمال کرنی چاہیے۔ یہ بھی تصدیق کریں کہ ایڈریس اس ماحول سے قابل رسائی ہے جہاں Hermes چلتا ہے۔ اگر Hermes اور OmniProxy ایک ہی کمپیوٹر پر ہیں، تو آپ مقامی ایڈریس استعمال کر سکتے ہیں۔

ٹول کنفیگریشن درج کریں

سب سے پہلے، موجودہ چیٹ سے باہر نکلیں، پھر ٹرمینل میں یہ چلائیں:

hermes model

Custom endpoint (self-hosted / VLLM / etc.) منتخب کریں۔ کسٹم اینڈ پوائنٹ کا مطلب ہے کہ Hermes ایک سروس ایڈریس سے جڑتا ہے جس کی آپ وضاحت کرتے ہیں بجائے اس کے کہ پہلے سے سیٹ پرووائیڈر استعمال کریں۔

سیٹ اپ وزرڈ ترتیب وار اینڈ پوائنٹ URL، کلید، اور ماڈل کے نام کے بارے میں پوچھتا ہے۔ پچھلے سیکشن سے تین اقدار درج کریں۔ 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 چل رہا ہے اور چیک کریں کہ بیس URL /v1 پر ختم ہوتا ہے۔ اگر Hermes Docker میں چلتا ہے جبکہ OmniProxy ہوسٹ پر چلتا ہے، تو 127.0.0.1 استعمال نہ کریں اگر یہ صرف کنٹینر کے اندر درست ہے۔
• کلید کی غلطی ظاہر ہوتی ہے: OmniProxy کلید اپ ڈیٹ کریں، پھر config.yaml میں api_key تبدیل کریں۔ xAI یا Google کلید OmniProxy کی پرووائیڈر سیٹنگز میں ہونی چاہیے؛ اسے Hermes کے اس فیلڈ میں درج نہ کریں۔
• ماڈل کو غیر دستیاب رپورٹ کیا جاتا ہے: OmniProxy میں موجودہ ماڈل لسٹ کھولیں اور grok-4.7 یا gemini-3.8-flash کو بالکل اسی طرح کاپی کریں جیسا کہ یہ لسٹ میں ظاہر ہوتا ہے۔
• Hermes جواب دیتا ہے لیکن فائلیں پڑھنے یا کمانڈز چلانے جیسے کام نہیں کر سکتا: OmniProxy میں کسی دوسرے ماڈل پر سوئچ کریں جس میں وہ صلاحیتیں ہوں، پھر ایک نیا Hermes سیشن شروع کریں۔
• پروگرام بیرونی ڈرائیو پر ہے، اور ڈرائیو منقطع ہونے کے بعد hermes doctor اسٹوریج کی غلطی رپورٹ کرتا ہے: پہلے ڈرائیو دوبارہ جوڑیں۔ Hermes کو الگ کنفیگریشن بنانے نہ دیں جب ڈرائیو منقطع ہو۔

حوالہ جات

تنصیب کے مراحل کے لیے، Hermes تنصیب دستاویزات اور پلیٹ فارم سپورٹ دیکھیں۔ کسٹم اینڈ پوائنٹ کنفیگریشن کے لیے، Hermes پرووائیڈر دستاویزات دیکھیں۔ ماڈل IDs کے لیے، Grok ماڈل دستاویزات اور Gemini کی OpenAI مطابقت دستاویزات دیکھیں۔

macOS تنصیب کا عمل 9 اکتوبر 2026 کو Hermes Agent v0.21.6 کا استعمال کرتے ہوئے مکمل کیا گیا تھا۔ grok-4.7 اور gemini-3.8-flash اس تاریخ کو xAI اور Google دستاویزات میں معیاری ماڈل IDs تھے۔ اقدار درج کرتے وقت، OmniProxy میں دکھائے گئے نام استعمال کریں۔

اپنے ذاتی OmniProxy ترتیب سے ہر پلس ہولڈر کو ویلیوز سے تبدیل کریں۔ کبھی بھی حقیقی کنج شائع نہ کریں۔

محفوظ شدہ نتیجہ یا HTTP 200 اکیلے مکمل ایجنٹ مطابقت ثابت نہیں کرتا۔ OmniProxy کی کال ریکارڈ میں ذریعہ اور ماڈل چیک کریں۔

سرکاری ذرائع · Hermes ↗