Hermes ইনস্টল করা এবং OmniProxy কনফিগার করা

Hermes হলো এমন একটি অ্যাসিস্ট্যান্ট যা কথোপকথন এবং কাজের অভিজ্ঞতা ধরে রাখতে পারে, সম্পন্ন কাজকে এমন দক্ষতায় পরিণত করে যা পরে পুনরায় ব্যবহার করা যায়। একটি একক গেটওয়ের মাধ্যমে, এটি Telegram, Discord, Slack, WhatsApp, Signal এবং টার্মিনালের সাথেও কানেক্ট করতে পারে। গেটওয়েটি বার্তা গ্রহণ এবং ফরোয়ার্ড করার জন্য একটি সমন্বিত এন্ট্রি পয়েন্ট হিসেবে কাজ করে। আপনি আপনার সাধারণ চ্যাট টুলগুলো থেকে কোড রিভিউ, ইনসিডেন্ট নোট বা গ্রাহকের উপকরণ পাঠাতে পারেন, তারপর সেটিকে রিপোজিটরিতে ফিরিয়ে এনে কাজ চালিয়ে যেতে পারেন।

শুরু করার আগে

প্রথমে, আপনার কম্পিউটারের অপারেটিং সিস্টেমের উপর ভিত্তি করে একটি ইনস্টলেশন পদ্ধতি বেছে নিন। 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 সিলিকন সাপোর্ট করে; ইন্টেল Mac সমর্থিত নয়।
• 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; এই ইনস্টলেশন চেকটি আপনাকে বলে যে কী এখনো অনুপস্থিত।

একটি এক্সটার্নাল ড্রাইভে প্রোগ্রামটি সংরক্ষণ করুন

৯ অক্টোবর, ২০২৬ তারিখে, 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 সার্ভিস URL কনফিগার করুন; 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 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করুন। API এন্ডপয়েন্ট হিসেবে OmniProxy ঠিকানা ব্যবহার চালিয়ে যান।

OmniProxy থেকে এন্ডপয়েন্ট URL এবং কী কপি করুন, তারপর সংশ্লিষ্ট মডেল ID প্রবেশ করান:

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 একটি প্রিসেট প্রোভাইডার ব্যবহার না করে আপনার নির্দিষ্ট করা একটি সার্ভিস ঠিকানায় কানেক্ট করে।

সেটআপ উইজার্ড ক্রমানুসারে এন্ডপয়েন্ট 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

রিকোয়েস্ট লগ খুলুন

• মডেলের নাম যাচাই করুন

১. চালান hermes doctor ইনস্টলেশন সম্পন্ন হয়েছে কিনা তা চেক করতে। ২. চালান hermes এবং এটিকে এক বাক্যে ব্যাখ্যা করতে বলুন যে এটি কী করতে পারে। আপনার একটি রেসপন্স দেখা উচিত। ৩. 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। মডেল IDগুলোর জন্য, দেখুন Grok model documentation এবং Gemini’s OpenAI compatibility documentation।

macOS ইনস্টলেশন প্রক্রিয়াটি ৯ অক্টোবর, ২০২৬ তারিখে Hermes Agent v0.21.6 ব্যবহার করে সম্পন্ন হয়েছিল। grok-4.7 এবং gemini-3.8-flash ছিল সেই তারিখে xAI এবং Google ডকুমেন্টেশনে স্ট্যান্ডার্ড মডেল ID। ভ্যালুগুলো প্রবেশ করানোর সময়, OmniProxy-তে প্রদর্শিত নামগুলো ব্যবহার করুন।

আপনার নিজস্ব OmniProxy কনফিগারেশন থেকে প্রতিটি প্লেসহোল্ডার মান দিয়ে প্রতিস্থাপন করুন। কখনোই একটি বাস্তব কি প্রকাশ করবেন না।

একটি সংরক্ষিত ফলাফল বা HTTP 200 নিজে থেকেই এজেন্টের পূর্ণ সামঞ্জস্যতা প্রমাণ করে না। OmniProxy-এর কল লগে উৎস এবং মডেল পরীক্ষা করুন।

অফিশিয়াল উৎস · Hermes ↗