Windows पर Hermes AI इंस्टॉल करें: Desktop, PowerShell और WSL2

Hermes Agent, Windows 10 और Windows 11 दोनों का समर्थन करता है। उपयोगकर्ताओं के लिए तीन डिप्लॉयमेंट विकल्प उपलब्ध हैं: PowerShell के ज़रिए नेटिव निष्पादन, Hermes Desktop ग्राफिकल एप्लिकेशन और WSL2 एनवायरनमेंट। सही विकल्प का चयन आपके आवश्यक बिल्ड टूल्स, टर्मिनल आवश्यकताओं और फ़ाइल सिस्टम आर्किटेक्चर पर निर्भर करता है।

इंस्टॉलेशन पाथ का चयन: नेटिव एनवायरनमेंट बनाम WSL2

इंस्टॉलेशन से पहले, अपने कार्यों के रनटाइम संदर्भ को निर्धारित करना आवश्यक है:

• नेटिव PowerShell और Hermes Desktop समान डेटा लेआउट साझा करते हैं: सोर्स कोड और वर्चुअल एनवायरनमेंट %LOCALAPPDATA%\hermes\hermes-agent में रहते हैं, जबकि उपयोगकर्ता सेटिंग्स, सेशन हिस्ट्री और स्किल्स %LOCALAPPDATA%\hermes में संग्रहीत होते हैं। डेस्कटॉप इंटरफ़ेस और कंसोल CLI एक-दूसरे के पूरक हैं और बिल्कुल समान स्थिति पर काम करते हैं।
• WSL2 एनवायरनमेंट को एक Linux वर्चुअल मशीन के अंदर अलग रखता है और कॉन्फ़िगरेशन को ~/.hermes में अलग से संग्रहीत करता है।

आर्किटेक्चर चयन के उदाहरण

1. Windows-केंद्रित प्रोजेक्ट (PowerShell / .NET / सिस्टम यूटिलिटीज़): यदि आप होस्ट वर्कफ़्लो को ऑटोमेट करते हैं, Windows Task Scheduler के ज़रिए Telegram या Discord के लिए बैकग्राउंड गेटवे चलाते हैं, और लोकल NTFS फ़ाइलों पर काम करते हैं, तो नेटिव PowerShell या Hermes Desktop चुनें।
2. Linux-स्टैक प्रोजेक्ट (Docker, Make, POSIX स्क्रिप्ट्स): यदि आपके एजेंट को Linux बाइनरीज़ कंपाइल करने, UNIX सॉकेट्स के साथ इंटरैक्ट करने, या वेब डैशबोर्ड में बिल्ट-इन टर्मिनल के ज़रिए सेशन मैनेज करने की आवश्यकता है, तो एजेंट को WSL2 में डिप्लॉय करें। नेटिव Windows बिल्ड में वेब डैशबोर्ड मेट्रिक्स और कॉन्फ़िगरेशन को सपोर्ट करता है, लेकिन /chat एम्बेडेड टर्मिनल टैब के लिए POSIX PTY की आवश्यकता होती है और यह केवल WSL2 में उपलब्ध है।

---

विकल्प 1: PowerShell के ज़रिए नेटिव इंस्टॉलेशन

नेटिव इंस्टॉलर के लिए एडमिनिस्ट्रेटर अधिकारों की आवश्यकता नहीं होती है और यह स्वचालित रूप से uv पैकेज मैनेजर, एक आइसोलेटेड Python 3.11 रनटाइम, ब्राउज़र ऑटोमेशन टूल्स के लिए Node.js और PortableGit को कॉन्फ़िगर करता है। आपको अपने सिस्टम में वैश्विक स्तर पर Python इंस्टॉल करने की आवश्यकता नहीं है।

एक सामान्य PowerShell कंसोल खोलें और चलाएं:

iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)

यह स्क्रिप्ट वर्तमान उपयोगकर्ता के PATH एनवायरनमेंट वेरिएबल में %LOCALAPPDATA%\hermes\bin जोड़ती है। स्क्रिप्ट समाप्त होने के बाद, कंसोल विंडो बंद करें और अपडेट किए गए PATH को लागू करने के लिए एक नया टर्मिनल सत्र खोलें। उन्नत स्क्रिप्ट पैरामीटर के लिए, आधिकारिक Windows Native गाइड देखें।

---

विकल्प 2: Hermes Desktop ग्राफिकल क्लाइंट

Hermes Desktop एक विंडो वाला इंटरफ़ेस प्रदान करता है जिसमें सेशन साइडबार, विज़ुअल स्किल ग्राफ, टैब सपोर्ट और पैरेलल एजेंट मैनेजमेंट शामिल हैं।

1. Hermes Desktop डॉक्यूमेंटेशन पेज से इंस्टॉलर डाउनलोड करें।
2. डाउनलोड की गई इंस्टॉलर फ़ाइल को चलाएं। पहली बार लॉन्च होने पर, एप्लिकेशन स्वचालित रूप से %LOCALAPPDATA%\hermes डायरेक्टरी में डिपेंडेंसी सेटअप स्क्रिप्ट को ट्रिगर करेगा।

यदि आप पहले ही PowerShell के माध्यम से एजेंट को कॉन्फ़िगर कर चुके हैं, तो डेस्कटॉप एप्लिकेशन मौजूदा API की और सहेजी गई बातचीत को तुरंत लोड कर लेगा।

---

विकल्प 3: WSL2 के अंदर इंस्टॉलेशन

WSL2 एक मानक Linux एनवायरनमेंट (ext4 फ़ाइल सिस्टम, POSIX सिग्नल्स, PTY सपोर्ट) प्रदान करता है।

चरण 1: WSL2 तैयार करें

एडमिनिस्ट्रेटर अधिकारों वाले PowerShell कंसोल में (Run as Administrator) चलाएं:

wsl --install

यदि सिस्टम द्वारा संकेत दिया जाए तो अपना कंप्यूटर पुनरारंभ करें, फिर अपना Linux यूज़रनेम और पासवर्ड सेट करें। इसके बाद, अपने डिस्ट्रीब्यूशन वर्ज़न की पुष्टि करें:

wsl --list --verbose

सुनिश्चित करें कि आपके चयनित डिस्ट्रीब्यूशन (डिफ़ॉल्ट रूप से Ubuntu) के लिए VERSION कॉलम में 2 प्रदर्शित हो रहा है।

चरण 2: Hermes Agent डिप्लॉय करें

अपना Ubuntu टर्मिनल खोलें और WSL2 क्विकस्टार्ट गाइड के अनुसार इंस्टॉलेशन कमांड चलाएं:

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

महत्वपूर्ण: अपने वर्किंग रिपॉजिटरीज़ और प्रोजेक्ट फ़ाइलों को Linux फ़ाइल सिस्टम के अंदर रखें (उदाहरण के लिए, ~/projects/), न कि माउंटेड Windows ड्राइव (/mnt/c/) पर। 9P प्रोटोकॉल पर क्रॉस-बाउंड्री फ़ाइल कॉल्स के कारण I/O परफ़ॉर्मेंस धीमी हो सकती है और git ऑपरेशंस में सुस्ती आ सकती है।

---

एनवायरनमेंट वेरिफिकेशन और पहला रन

डायग्नोस्टिक्स और निष्पादन प्रत्येक एनवायरनमेंट के संबंधित टर्मिनल में किया जाना चाहिए: नेटिव इंस्टॉलेशन और Hermes Desktop के लिए PowerShell का उपयोग करें, और WSL2 के लिए Ubuntu टर्मिनल का उपयोग करें।

नेटिव इंस्टॉलेशन और Hermes Desktop के लिए, एक नया PowerShell सत्र खोलें और चलाएं:

Get-Command hermes
hermes --version
hermes doctor

WSL2 इंस्टॉलेशन के लिए, Ubuntu टर्मिनल खोलें और डायग्नोस्टिक्स चलाएं:

command -v hermes
hermes --version
hermes doctor

hermes doctor कमांड git, Chromium ब्राउज़र इंजन और सहायक डिपेंडेंसीज़ के लिए पाथ रिज़ॉल्यूशन का विश्लेषण करता है।

चैट सत्र शुरू करने से पहले, अपने मॉडल प्रदाता को कॉन्फ़िगर करें: यदि यह पहले से सेट नहीं है, तो पहले hermes setup चलाएं और अपना मॉडल प्रदाता चुनें (नेटिव एनवायरनमेंट के लिए PowerShell में, या WSL2 के लिए Ubuntu टर्मिनल में)।

कॉन्फ़िगरेशन के बाद, अपने टर्मिनल में सामान्य बातचीत शुरू करें और ऐसे कार्य के साथ इसका परीक्षण करें जिसमें फ़ाइल राइट की आवश्यकता न हो; ध्यान दें कि hermes chat में अनुमति सैंडबॉक्सिंग लागू नहीं होती है:

hermes chat

अपने पहले प्रॉम्प्ट के रूप में, ऐसा निर्देश दें जिसमें डिस्क पर लिखने की आवश्यकता न हो (जैसे कि किसी आर्किटेक्चरल अवधारणा की व्याख्या पूछना)। अपेक्षित परिणाम आपके कॉन्फ़िगर किए गए मॉडल प्रदाता का सफल इनिशियलाइज़ेशन और बिना एन्कोडिंग त्रुटियों के क्लीन स्ट्रीमिंग टेक्स्ट आउटपुट है।

वैकल्पिक मॉडल कॉन्फ़िगरेशन विवरण के लिए, BetterToken डॉक्यूमेंटेशन देखें।

---

सामान्य समस्याओं का निवारण

देखा गया लक्षण	कारण	समाधान
hermes: The term 'hermes' is not recognized	सक्रिय कंसोल सत्र ने अपडेट किए गए User PATH को पुनः लोड नहीं किया है।	अपनी PowerShell विंडो को पुनरारंभ करें या बाइनरी को सीधे कॉल करें: & "$env:LOCALAPPDATA\hermes\bin\hermes.exe"।
वेब डैशबोर्ड में /chat टैब एक एरर बैनर दिखाता है	नेटिव Windows में POSIX PTY सिस्टम मैकेनिज़्म का अभाव है।	सेशन और टास्क मैनेजमेंट नेटिव रूप से काम करता है, लेकिन /chat में वेब टर्मिनल के लिए एजेंट को WSL2 के अंदर चलाएं।
WinError 193: %1 is not a valid Win32 application	.cmd रैपर को बायपास करके सीधे स्क्रिप्ट को कॉल करने का प्रयास।	Windows पर, Node और npm टूल्स को उनके स्पष्ट एक्सटेंशन के साथ निष्पादित करें (उदाहरण के लिए, npx.cmd)।
CLI में यूनिकोड वर्णों के स्थान पर प्रश्न चिह्न (?)	पुराना कंसोल होस्ट जिसमें CP 65001 का समर्थन नहीं है।	Windows Terminal का उपयोग करें। सुनिश्चित करें कि HERMES_DISABLE_WINDOWS_UTF8 एनवायरनमेंट वेरिएबल 1 पर सेट नहीं है।
WSL2 के अंदर git status के दौरान उच्च विलंबता	प्रोजेक्ट की वर्किंग डायरेक्टरी /mnt/c/... पाथ पर स्थित है।	नेटिव ext4 परफ़ॉर्मेंस का लाभ उठाने के लिए रिपॉजिटरी को डिस्ट्रो की Linux होम डायरेक्टरी (~/code/...) में स्थानांतरित करें।