دستیار خودمختار

Hermes Agent با مدل‌های آی‌کار

Hermes Agent دستیار متن‌باز Nous Research است: حافظه‌ی ماندگار دارد، برای کارهای تکراری «مهارت» می‌سازد و بهترشان می‌کند، و در ترمینال یا پیام‌رسان‌هایی مثل تلگرام و دیسکورد کار می‌کند. با گزینه‌ی Custom endpoint آن را به مدل‌های آی‌کار وصل کنید.

API base URL در Hermes

https://api.ai-kar.com/v1

مدل پیشنهادی برای شروع

claude-sonnet-5-5

ساخت کلید API

در پنل کاربری، بخش توسعه‌دهندگان (API) یک کلید بسازید. Hermes برای هر پیام چند درخواست می‌فرستد؛ مصرف را در «گزارش مصرف» ببینید.

ورود به پنل و ساخت کلید

نصب Hermes

با یک دستور روی لینوکس، مک، WSL2 یا ویندوز نصب می‌شود. برای اجرای دائمی (مثلاً ربات تلگرام) آن را روی یک سرور مجازی نصب کنید.

دستور نصب

انتخاب Custom endpoint

دستور hermes model را اجرا کنید، «Custom endpoint» را بردارید و آدرس، کلید و نام مدل آی‌کار را وارد کنید.

مقادیر تنظیمات

نصب

یک دستور

دستور مناسب سیستم‌عامل خود را اجرا کنید. پس از نصب، ترمینال را دوباره باز کنید تا دستور hermes شناخته شود.

برای کار دائمی

برای ربات پیام‌رسان یا کارهای زمان‌بندی‌شده، Hermes را روی یک VPS نصب کنید تا همیشه روشن بماند.

Install

# 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 model

از فهرست، Custom endpoint (self-hosted / VLLM / etc.) را انتخاب کنید و آدرس https://api.ai-kar.com/v1، کلید و شناسه‌ی مدل را وارد کنید. تنظیم در ~/.hermes/config.yaml ذخیره می‌شود و با هر بار اجرا باقی می‌ماند.

راه ۲: فایل تنظیمات

بخش model را مثل نمونه بنویسید و کلید را در ~/.hermes/.env بگذارید (کلید را در config.yaml ننویسید).context_length را مطابق مدل بگذارید (۲۰۰۰۰۰ برای Claude، ۱۰۰۰۰۰۰ برای DeepSeek V4).

حداقل context: ۶۴ هزار توکن

Hermes برای کار با ابزارها دست‌کم ۶۴K context لازم دارد. همه‌ی مدل‌های پیشنهادی پایین این شرط را دارند؛ مدل‌های کوچک‌تر را برنگزینید.

تعویض مدل وسط کار

با اجرای دوباره‌ی hermes model می‌توانید مدل را عوض کنید؛ مثلاً برای کارهای ساده مدل ارزان و برای کارهای سخت Claude.

hermes model

Provider

Custom endpoint▾

API base URL

https://api.ai-kar.com/v1

API key

ak_xxxxxxxxxxxxxxxxxxxxxxxx

Model name

claude-sonnet-5-5

Terminal

$ hermes model
? Select provider:  Custom endpoint (self-hosted / VLLM / etc.)
? API base URL:     https://api.ai-kar.com/v1
? API key:          ak_xxxxxxxxxxxxxxxxxxxxxxxx
? Model name:       claude-sonnet-5-5

$ hermes            # start chatting in the terminal

~/.hermes/config.yaml

# ~/.hermes/config.yaml
model:
  default: claude-sonnet-5-5
  provider: custom
  base_url: https://api.ai-kar.com/v1
  key_env: AIKAR_API_KEY
  context_length: 200000

~/.hermes/.env

# ~/.hermes/.env
AIKAR_API_KEY=ak_xxxxxxxxxxxxxxxxxxxxxxxx

تلگرام، دیسکورد و پیام‌رسان‌های دیگر

Gateway

Hermes می‌تواند همان دستیار را در تلگرام، دیسکورد، اسلک، واتس‌اپ، سیگنال و ایمیل در دسترس بگذارد. با hermes setup پیام‌رسان را تنظیم و با hermes gateway اجرا کنید؛ مدل همان مدل آی‌کار است که انتخاب کرده‌اید.

هزینه را کنترل کنید

در حالت پیام‌رسان، هر پیام کاربران هزینه دارد. برای ربات‌های عمومی مدل ارزان بگذارید و مصرف را در «گزارش مصرف» پیگیری کنید.

Terminal

hermes gateway      # Telegram, Discord, Slack, WhatsApp, ...
hermes setup        # full setup wizard (messaging, tools, ...)

مدل‌های پیشنهادی برای Hermes

claude-sonnet-5-5

بهترین تعادل برای agent: ابزارها را دقیق صدا می‌زند و برنامه‌ریزی چندمرحله‌ای خوبی دارد.

deepseek-v4-1-flash

ارزان با context یک میلیونی؛ برای استفاده‌ی روزانه و طولانی.

gpt-6-1-sol

استدلال قوی برای کارهای پیچیده.

kimi-k3

context یک میلیونی و قوی در کد و ابزار.

deepseek/deepseek-v4-pro

پروژه‌ها و اسناد بزرگ.

grok-4-7

سریع با context بزرگ.

Hermes مدام ابزار صدا می‌زند؛ مدلی بگیرید که در فراخوانی ابزار دقیق باشد. فهرست کامل و شناسه‌ی همه‌ی مدل‌ها در برگه‌ی مدل‌ها و قیمت‌ها در تعرفه‌ها.

سؤال‌های رایج و رفع اشکال

خطای 401.+

کلید در ~/.hermes/.env درست نیست یا نام متغیر با key_env یکی نیست. کلید را دوباره کپی کنید.

Model not found.+

شناسه را دقیقاً از برگه‌ی مدل‌ها بردارید (مثلاً claude-sonnet-5-5، نه Claude Sonnet).

پاسخ‌ها ناقص می‌ماند یا ابزارها اجرا نمی‌شوند.+

مدلی با context کمتر از ۶۴K یا مدلی بدون پشتیبانی خوب از ابزار انتخاب شده است. یکی از مدل‌های پیشنهادی را بردارید و context_length را درست بگذارید.

خطای «موجودی کافی نیست».+

هر درخواست پیش از ارسال با هزینه‌ی تقریبی بررسی می‌شود؛ کیف پول را شارژ کنید.