نصب Hermes و پیکربندی OmniProxy

Hermes دستیاری است که می‌تواند مکالمات و تجربه وظایف را حفظ کند و کارهای تکمیل‌شده را به مهارت‌هایی تبدیل کند که بعداً قابل استفاده مجدد باشند. از طریق یک درگاه واحد، همچنین می‌تواند به تلگرام، دیسکورد، اسلک، واتس‌اپ، سیگنال و ترمینال متصل شود. درگاه به عنوان یک نقطه ورود واحد برای دریافت و ارسال پیام‌ها عمل می‌کند. می‌توانید بررسی‌های کد، یادداشت‌های حادثه یا مطالب مشتری را از ابزارهای چت معمول خود برای آن بفرستید، سپس از آن بخواهید به مخزن بازگردد و به کار خود ادامه دهد.

قبل از شروع

ابتدا یک روش نصب بر اساس سیستم عامل رایانه خود انتخاب کنید. مک و ویندوز می‌توانند مستقیماً از نصب‌کننده‌های گرافیکی استفاده کنند، در حالی که لینوکس، مک و WSL2 می‌توانند از یک اسکریپت ترمینال استفاده کنند. WSL2 یک ویژگی ویندوز برای اجرای محیط لینوکس است. Termux در تلفن‌های اندرویدی و Docker روش‌های نصب خود را دارند، اما این راهنما فقط نصب روی رایانه‌های معمولی را پوشش می‌دهد.

پنجره می‌خواهید

مک، ویندوز

• مک: DMG را باز کنید
• ویندوز: نصب‌کننده را باز کنید
• برنامه را روی سیستم نصب کنید

فقط ترمینال

لینوکس، مک، WSL2

• یک دستور install.sh
• استفاده از install.ps1 در ویندوز
• پس از نصب hermes را وارد کنید

هنوز از این‌ها استفاده نکنید

pip, brew, AUR

• این روش‌های نصب به‌طور رسمی پشتیبانی نمی‌شوند
• به‌روزرسانی آن‌ها پس از نصب نیز دشوار است
• به جای آن از یکی از دو گزینه سمت چپ استفاده کنید

قبل از شروع، یک رایانه مک، ویندوز یا لینوکس آماده کنید و مطمئن شوید که می‌تواند ترمینال را باز کرده و به GitHub دسترسی داشته باشد. اگر قصد دارید Hermes را روی یک درایو خارجی نصب کنید، ابتدا درایو را متصل کرده و تأیید کنید که فضای خالی کافی دارد.

نصب و اولین اجرا

اگر برنامه گرافیکی می‌خواهید

به بخش دانلود در وب‌سایت Hermes بروید و نصب‌کننده سیستم عامل خود را دانلود کنید. نصب‌کننده از قبل شامل محیط اجرایی است، بنابراین هنگام باز کردن آن برای اولین بار، نیازی به کامپایل محلی نیست.

• مک: DMG را باز کنید و Hermes.app را به Applications منتقل کنید. DMG یک تصویر نصب است که معمولاً در مک استفاده می‌شود. این نصب‌کننده فقط از سیلیکون اپل پشتیبانی می‌کند؛ مک‌های اینتل پشتیبانی نمی‌شوند.
• ویندوز: فایل .appinstaller را با Windows App Installer باز کنید. این یک MSIX امضا شده را نصب می‌کند، نوعی بسته برنامه که توسط ویندوز استفاده می‌شود.
• لینوکس: نصب‌کننده‌های دسکتاپ برای مک و ویندوز هستند. در لینوکس، از دستور ترمینال زیر استفاده کنید. پس از نصب، می‌توانید اجرا کنید hermes desktop.

اگر فقط به ترمینال نیاز دارید

اگر از لینوکس، مک یا WSL2 استفاده می‌کنید، این را در ترمینال اجرا کنید:

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

هنگام استفاده از PowerShell موجود در ویندوز، اجرا کنید:

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

نصب‌کننده کد Hermes و برنامه‌های مورد نیاز برای اجرای آن را دانلود می‌کند. اگر دانلود قطع شد، همان دستور را دوباره اجرا کنید. پس از پایان نصب، ترمینال فعلی را ببندید، یک پنجره جدید باز کنید و وارد کنید:

hermes

اگر اعلان Hermes را می‌بینید، دستور آماده استفاده است. سپس می‌توانید اجرا کنید hermes doctor؛ این بررسی نصب به شما می‌گوید چه چیزی هنوز گم شده است.

ذخیره برنامه روی درایو خارجی

در تاریخ 9 اکتبر 2026، Hermes Agent v0.21.6 روی یک درایو خارجی متصل به مک نصب شد. برنامه در /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

→

درگاه محلی

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 گوگل است 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.) را انتخاب کنید. Custom endpoint به این معنی است که 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 لیست دایرکتوری‌هایی است که سیستم در آن‌ها به دنبال دستورات می‌گردد. در ویندوز، تأیید کنید که دایرکتوری راه‌اندازی اضافه شده توسط نصب‌کننده در PATH است.
• دانلود نصب در میانه راه متوقف می‌شود: همان دستور نصب را دوباره اجرا کنید. بخش‌هایی که قبلاً دانلود شده‌اند دوباره استفاده می‌شوند.
• Hermes پاسخ نمی‌دهد یا گزارش می‌دهد که نمی‌تواند متصل شود: تأیید کنید که OmniProxy در حال اجرا است و بررسی کنید که Base URL به /v1ختم می‌شود. اگر Hermes در Docker اجرا می‌شود در حالی که OmniProxy روی میزبان اجرا می‌شود، از آن استفاده نکنید 127.0.0.1 اگر فقط در داخل کانتینر معتبر است.
• خطای کلید ظاهر می‌شود: کلید OmniProxy را به‌روزرسانی کنید، سپس تغییر دهید api_key در config.yaml. کلید xAI یا گوگل متعلق به تنظیمات ارائه‌دهنده OmniProxy است؛ آن را در این فیلد Hermes وارد نکنید.
• مدل به عنوان غیرقابل دسترس گزارش می‌شود: لیست مدل فعلی را در OmniProxy باز کنید و کپی کنید grok-4.7 یا gemini-3.8-flash دقیقاً همانطور که در لیست ظاهر می‌شود.
• Hermes پاسخ می‌دهد اما نمی‌تواند وظایفی مانند خواندن فایل‌ها یا اجرای دستورات را انجام دهد: به مدل دیگری در OmniProxy بروید که آن قابلیت‌ها را دارد، سپس یک جلسه Hermes جدید شروع کنید.
• برنامه روی درایو خارجی است و hermes doctor پس از جدا کردن درایو، خطای ذخیره‌سازی گزارش می‌دهد: ابتدا درایو را دوباره متصل کنید. اجازه ندهید Hermes در حالی که درایو جدا شده است، پیکربندی جداگانه‌ای ایجاد کند.

مراجع

برای مراحل نصب، ببینید مستندات نصب Hermes و پشتیبانی پلتفرم. برای پیکربندی Custom endpoint، ببینید مستندات ارائه‌دهنده Hermes. برای شناسه‌های مدل، ببینید مستندات مدل Grok و مستندات سازگاری OpenAI Gemini.

فرآیند نصب مک در تاریخ 9 اکتبر 2026 با استفاده از Hermes Agent v0.21.6 تکمیل شد. grok-4.7 و gemini-3.8-flash شناسه‌های مدل استاندارد در مستندات xAI و گوگل در آن تاریخ بودند. هنگام وارد کردن مقادیر، از نام‌های نمایش داده شده در OmniProxy استفاده کنید.

هر جایگاه را با مقادیر از پیکربندی OmniProxy خود جایگزین کنید. هرگز یک کلید واقعی را منتشر نکنید.

یک نتیجه ذخیره شده یا HTTP 200 به تنهایی سازگاری کامل عامل را اثبات نمی‌کند. منبع و مدل را در گزارش درخواست OmniProxy بررسی کنید.

منابع رسمی · Hermes ↗