Hermes Agent یک ایجنت متن‌باز و ترمینال‌محور برای کدنویسی و کارهای خودمختار است که
توسط Nous Research ساخته شده. حافظهٔ ماندگار، مهارت‌های قابل ساخت توسط خود ایجنت و
یک درگاه پیام‌رسانی با پشتیبانی از بیش از ۲۱ پلتفرم (تلگرام، دیسکورد، اسلک، واتس‌اپ،
سیگنال، اس‌ام‌اس، ماتریس و بقیه) از ویژگی‌های آن است.

Hermes روی پس‌زمینه‌های لوکال، Docker، SSH، Daytona، Modal، Vercel Sandbox یا
Singularity اجرا می‌شود و با چند ارائه‌دهندهٔ مدل — از جمله آشا برای دسترسی به مدل‌های
متنوع با یک کلید — کار می‌کند.

راه‌اندازی

نکتهٔ مهم: چرا آدرس پایه؟

آشا یک درگاه سازگار با OpenAI است و در فهرست ارائه‌دهنده‌های پیش‌فرض Hermes نیست؛ به همین
دلیل Hermes مجبور است از حالت «ارائه‌دهندهٔ سفارشی» (custom) استفاده کند. در این حالت
باید آدرس پایهٔ API آشا را صریحاً به Hermes بدهید تا بداند درخواست‌ها را به کجا بفرستد.
این دقیقاً همان جایی است که آشا به‌عنوان پروکسی وارد می‌شود؛ کلید و آدرس آشا را می‌دهید و
Hermes همهٔ درخواست‌ها را از طریق آشا ارسال می‌کند.

شروع سریع (متغیر محیطی)

اگر از قبل کلید آشا را دارید:

Terminal
bash 
hermes config set OPENAI_API_KEY sk-asha-...

Hermes برای انتهای سفارشی سازگار با OpenAI از متغیر OPENAI_API_KEY استفاده
می‌کند (نه ASHA_API_KEY).

سپس گفت‌وگو را شروع کنید:

Terminal
bash 
hermes chat --provider custom --model 'deepseek/deepseek-v4-flash'

پیکربندی دستی

پیکربندی دستی زیر تنها راهی است که آدرس پایهٔ آشا را به Hermes معرفی می‌کند؛ برای همهٔ
کاربران توصیه می‌شود.

گام ۱ — دریافت کلید API آشا

  • در پنل کاربری آشا ثبت‌نام یا وارد شوید.
  • به صفحهٔ کلیدهای API بروید و یک کلید جدید بسازید.
  • کلید را کپی کنید (با قالب sk-asha-... شروع می‌شود).

گام ۲ — قرار دادن کلید

کلید آشا را به ~/.hermes/.env اضافه کنید:

ENV
~/.hermes/.env 
OPENAI_API_KEY=sk-asha-...

Hermes برای انتهای سفارشی سازگار با OpenAI از متغیر OPENAI_API_KEY استفاده می‌کند؛
ASHA_API_KEY را Hermes نمی‌شناسد. Hermes اسرار را از تنظیمات غیرحساس جدا نگه می‌دارد: کلیدهای API در
~/.hermes/.env و پیکربندی مدل و ارائه‌دهنده در
~/.hermes/config.yaml قرار می‌گیرند.

گام ۳ — پیکربندی مدل

فایل ~/.hermes/config.yaml را ویرایش کنید:

YAML
~/.hermes/config.yaml 
model:
  provider: custom
  base_url: https://app.asha-ai.ir/v1
  default: deepseek/deepseek-v4-flash
  api_mode: chat_completions

provider: custom به Hermes می‌گوید از یک انتهای سازگار با OpenAI استفاده
کند و base_url آدرس دقیق درگاه آشا را مشخص می‌کند. بدون این دو، Hermes هیچ
راهی برای رسیدن به آشا ندارد؛ این دقیقاً همان بخشی است که قبلاً گم شده بود. مدل ارجح را
به‌جای deepseek/deepseek-v4-flash بگذارید.

فهرست کامل مدل‌ها و شناسه‌های دقیق را در
فهرست مدل‌های آشا ببینید.

گام ۴ — شروع Hermes

Terminal
bash 
hermes          # CLI کلاسیک
hermes --tui    # رابط مدرن

از این لحظه ایجنت شما همهٔ درخواست‌ها را از طریق آشا به مدل انتخابی می‌فرستد.

قالب شناسهٔ مدل

وقتی از انتهای سفارشی آشا استفاده می‌کنید، Hermes از قالب استاندارد
<author>/<slug> پیروی می‌کند (با پیشوند اختیاری
~ برای آخرین نسخهٔ یک خانواده):

Model IDs
~/.hermes/config.yaml 
~anthropic/claude-sonnet-latest
~google/gemini-flash-latest
deepseek/deepseek-v4-flash
qwen/qwen3

مسیریابی ارائه‌دهنده

مسیریابی بین زیرساخت‌ها برای هر مدل در داخل آشا انجام می‌شود؛ Hermes فقط درخواست را به
آدرس پایهٔ آشا می‌فرستد. پسوندهای اختیاری :nitro (اولویت throughput) و
:floor (اولویت قیمت) روی نام مدل کار می‌کنند و از طریق آشا به‌صورت
بدون‌تغییر به ارائه‌دهندهٔ بالادست می‌رسند؛ مثل:
deepseek/deepseek-v4-flash:nitro.

ارائه‌دهندگان جایگزین (Fallback)

زنجیره‌ای از ارائه‌دهندگان پشتیبان را تنظیم کنید که وقتی مدل اصلی در دسترس نیست،
Hermes آن‌ها را امتحان کند:

YAML
~/.hermes/config.yaml 
fallback_providers:
  - provider: custom
    base_url: https://app.asha-ai.ir/v1
    model: ~anthropic/claude-sonnet-latest
  - provider: custom
    base_url: https://app.asha-ai.ir/v1
    model: ~google/gemini-flash-latest

این یک لایهٔ اطمینان اضافه است؛ هنگام فعال‌شدن، fallback مدل را وسط نشست عوض می‌کند
بدون اینکه گفت‌وگوی شما از بین برود.

مدل‌های کمکی (Auxiliary)

Hermes برای کارهای جانبی مثل فشرده‌سازی context، تحلیل تصویر، عنوان نشست و خلاصهٔ
وب از «مدل‌های کمکی» استفاده می‌کند. به‌طور پیش‌فرض از مدل اصلی استفاده می‌شود، اما
می‌توانید آن‌ها را به مدل‌های ارزان‌تر هدایت کنید:

YAML
~/.hermes/config.yaml 
auxiliary:
  title:
    provider: custom
    base_url: https://app.asha-ai.ir/v1
    model: ~google/gemini-flash-latest
  vision:
    provider: custom
    base_url: https://app.asha-ai.ir/v1
    model: ~google/gemini-flash-latest
  compression:
    provider: custom
    base_url: https://app.asha-ai.ir/v1
    model: ~google/gemini-flash-latest

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

نظارت بر مصرف

مصرف Hermes خود را به‌صورت لحظه‌ای دنبال کنید:

  • به داشبورد فعالیت آشا بروید.
  • درخواست‌ها، هزینه‌ها و مصرف توکن را در همهٔ نشست‌های Hermes ببینید.
  • بر اساس مدل، بازهٔ زمانی یا معیار دیگر فیلتر کنید.

خطاهای رایج

«No API key» یا «provider not found»

Hermes کلید آشا را پیدا نمی‌کند. بررسی کنید:

Terminal
bash 
cat ~/.hermes/.env | grep OPENAI

یا راه‌اندازی را دوباره انجام دهید: hermes config set OPENAI_API_KEY sk-asha-... یا hermes model.

خطاهای احراز هویت (401/403)

کلیدتان را در پنل بررسی کنید، مطمئن شوید کیف پول موجودی کافی دارد و کلید منقضی یا
ابطال نشده است.

مدل کار نمی‌کند

شناسهٔ مدل را در فهرست مدل‌های آشا بررسی کنید، از قالب
<author>/<slug> (با پیشوند ~ در صورت
نیاز) استفاده کنید و مطمئن شوید مدل در دسترس و منسوخ‌نشده است.

خطای طول context

Hermes به مدلی با حداقل ۶۴ هزار توکن context نیاز دارد؛ مدل‌های با پنجرهٔ کوچک‌تر در
زمان راه‌اندازی رد می‌شوند چون سیستم‌پرامپت و اسکیمای ابزارها می‌توانند پنجرهٔ کوچک را
پر کنند و جایی برای گفت‌وگو نماند. اگر چنین خطایی دیدید، به مدلی با پنجرهٔ بزرگ‌تر بروید.

جمع‌بندی

با همین چند گام، Hermes Agent شما به آشا وصل شد: مدل‌های متنوع با یک کلید، مسیریابی
باهوش، fallback قابل اطمینان و صورتحساب شفاف به تومان. برای مشاهدهٔ همهٔ مدل‌ها و
قیمت‌ها به مدل‌های آشا سر بزنید.