نصب و راه‌اندازی Hermes

دستیاری که روی کامپیوتر خودتان اجرا می‌شود و کار را تا آخر جلو می‌برد. نصبش چند دقیقه طول می‌کشد و بابت خودش پولی نمی‌دهید.

۱۴ دقیقهدرس ۸ از ۹۰ از ۸ قدم

Hermes یک ایجنت است. فرقش با چت این است که کار هم انجام می‌دهد: روی کامپیوتر شما اجرا می‌شود، در ترمینال دستور اجرا می‌کند، فایل می‌خواند و کار را قدم‌به‌قدم تا آخر جلو می‌برد.

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

پس فقط این‌ها را لازم دارید: خود Hermes، یک کلید ir- و کمی موجودی.

پیش از نصب

Hermes روی Linux، macOS، WSL2 و Windows نصب می‌شود. برای macOS و Windows نسخهٔ Desktop هم روی سایت خودش هست. مدلی که انتخاب می‌کنید باید دست‌کم ۶۴ هزار توکن context داشته باشد. این عدد در صفحهٔ هر مدل نوشته شده است.

قدم اول: کلید بسازید

یک کلید برای Hermes۰ از ۵ قدم

  1. به کلیدهای API بروید و «کلید تازه» را بزنید.
  2. اسمش را بگذارید «Hermes لپ‌تاپ».
  3. «این کلید از کجا هزینه شود؟» را روی «اعتباری (به‌ازای مصرف)» بگذارید.
  4. یک «سقف ماهانه» بگذارید. برای شروع، عددی کوچک کافی است.
  5. کلید را کپی کنید و تیک «کلید را جای امنی نگه داشتم» را بزنید. این کلید فقط همین یک بار نشان داده می‌شود.
ساختن کلید

قدم دوم: Hermes را نصب کنید

در Linux، macOS یا WSL2 ترمینال را باز کنید و این دستور را اجرا کنید:

Shell
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc   # یا ~/.zshrc

در Windows، در PowerShell:

powershell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
اگر نصب‌کننده وصل نشد، مشکل از دسترسی به سرور نصب است و ربطی به کلید شما ندارد. کمی بعد یا با اینترنت دیگری دوباره امتحان کنید.

قدم سوم: به ایران‌روتر وصلش کنید

فایل ~/.hermes/config.yaml را باز کنید و بخش model را این‌طور بنویسید. به‌جای ir-... کلید خودتان را بگذارید و شناسهٔ مدل را از صفحهٔ مدل‌ها بردارید:

YAML
model:
  provider: custom
  default: anthropic/claude-sonnet-4.6
  base_url: https://iranrouter.com/v1
  api_key: ir-...

اگر نمی‌خواهید فایل را دستی ویرایش کنید، hermes model را اجرا کنید، گزینهٔ custom endpoint را بردارید و همین نشانی و کلید را بدهید.

قدم چهارم: امتحان کنید

Shell
hermes --tui

بنویسید «سلام، این پوشه چه فایل‌هایی دارد؟» و صبر کنید جواب بدهد. اگر چیزی درست کار نکرد، hermes doctor مشکل را پیدا می‌کند.

ببینید درخواست از ایران‌روتر رد شده۰ از ۳ قدم

  1. به مصرف و لاگ‌ها بروید.
  2. باید همان درخواست را با نام مدل، تعداد توکن و هزینه ببینید.
  3. اگر چیزی نیست، base_url یا کلید درست تنظیم نشده است.
باز کردن لاگ‌ها

ایجنت چقدر خرج دارد

ایجنت برای یک کار ساده هم ممکن است چندین درخواست بزند و در هر کدام کل سابقهٔ کار را دوباره بفرستد. پس از یک گفت‌وگوی عادی گران‌تر درمی‌آید. سقف ماهانه را برای همین روی این کلید گذاشتیم: اگر کاری از کنترل خارج شود، خرج از عددی که خودتان تعیین کرده‌اید بالاتر نمی‌رود.

برای کارهای معمولی با مدل میان‌رده شروع کنید و فقط وقتی کار واقعاً سخت بود مدل قوی را بیاورید.

خلاصهٔ درس

  • Hermes رایگان و متن‌باز است و فقط مصرف مدل از کیف پول شما کم می‌شود.
  • با چهار خط در config.yaml به ایران‌روتر وصل می‌شود.
  • روی کلیدش حتماً سقف بگذارید.
وقتی گیر کردیدبیشتر گیرها با یک صفحه و شناسهٔ یک درخواست، در یک دقیقه باز می‌شوند.تمام کردم، درس بعد