• Getting Started
• Quickstart

شروع سریع

این راهنما شما را از صفر به یک نصب کاربردی Hermes می‌رساند که در استفاده واقعی دوام می‌آورد. نصب کنید، یک ارائه‌دهنده انتخاب کنید، یک چت کاربردی را تأیید کنید و دقیقاً بدانید وقتی چیزی خراب می‌شود چه کاری انجام دهید.

ترجیح می‌دهید تماشا کنید؟

Onchain AI Garage یک walkthrough جامع از نصب، تنظیم و فرمان‌های پایه تهیه کرده — یک همراه خوب برای این صفحه اگر ترجیح می‌دهید با ویدیو دنبال کنید. برای بیشتر، پلی‌لیست آموزش‌ها و موارد استفاده Hermes Agent را ببینید.

برای چه کسی است

• کاملاً جدید هستید و کوتاه‌ترین مسیر به یک نصب کاربردی می‌خواهید
• ارائه‌دهنده را عوض می‌کنید و نمی‌خواهید با اشتباهات پیکربندی وقت از دست دهید
• Hermes را برای یک تیم، ربات یا جریان کاری همیشه‌فعال راه‌اندازی می‌کنید
• از «نصب شد، ولی هنوز هیچ کاری نمی‌کند» خسته شده‌اید

سریع‌ترین مسیر

ردیفی که با هدف شما مطابقت دارد را انتخاب کنید:

قانون کلی: اگر Hermes نمی‌تواند یک چت عادی را تکمیل کند، هنوز ویژگی‌های بیشتری اضافه نکنید. ابتدا یک مکالمه تمیز را کار کنید، سپس gateway، cron، skillها، صدا یا مسیریابی را لایه‌بندی کنید.

۱. نصب Hermes Agent

با نصب‌کننده Hermes Desktop در macOS یا Windows (توصیه‌شده)

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

بدون Hermes Desktop:

برای نصب فقط خط فرمان بدون Hermes Desktop، دستور زیر را اجرا کنید:

Linux / macOS / WSL2 / Android (Termux)

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

Windows (بومی)

در powershell اجرا کنید:

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

اگر روی گوشی نصب می‌کنید، راهنمای Termux را برای مسیر دستی تست‌شده، اکستراهای پشتیبانی‌شده و محدودیت‌های فعلی مختص اندروید ببینید.

بعد از اتمام، shell خود را مجدداً بارگذاری کنید:

source ~/.bashrc   # یا source ~/.zshrc

برای گزینه‌های نصب دقیق، پیش‌نیازها و عیب‌یابی، راهنمای نصب را ببینید.

۲. انتخاب یک ارائه‌دهنده

مهم‌ترین قدم تنظیم. از hermes model برای راهنمایی تعاملی انتخاب استفاده کنید:

hermes model

یک اشتیاق ۳۰۰+ مدل به علاوه Tool Gateway (جستجوی وب، تولید تصویر، TTS، مرورگر ابری) را پوشش می‌دهد. در یک نصب جدید:

hermes setup --portal

شما را وارد می‌کند، Nous را به عنوان ارائه‌دهنده شما تنظیم می‌کند و Tool Gateway را با یک فرمان فعال می‌کند.

در یک نصب جدید، hermes setup سه حالت ارائه می‌دهد:

• Quick Setup (Nous Portal) — ورود OAuth رایگان، بدون کلید API؛ یک مدل به علاوه ابزارهای Tool Gateway را تنظیم می‌کند. مسیر سریع توصیه‌شده.
• Full Setup — هر ارائه‌دهنده، ابزار و گزینه را خودتان طی کنید (کلیدهای خودتان را بیاورید).
• Blank Slate — همه چیز خاموش است به جز حداقل مورد نیاز برای اجرای یک agent: ارائه‌دهنده و مدل، مجموعه ابزار File Operations و مجموعه ابزار Terminal. بدون وب، مرورگر، اجرای کد، بینایی، حافظه، تفویض، cron، skillها، پلاگین‌ها یا سرورهای MCP — و فشرده‌سازی، checkpointها، مسیریابی هوشمند و ثبت حافظه همه غیرفعال هستند. بعد از اعمال حداقل پایه، یکی از دو مسیر را انتخاب می‌کنید: شروع با همه چیز غیرفعال (اکنون با agent حداقل تمام کنید) یا طی تمام پیکربندی‌ها (ابزارها، skillها، پلاگین‌ها، MCP و پیام‌رسانی را انتخاب کنید). این را وقتی انتخاب کنید که یک agent حداقلی و کاملاً کنترل‌شده می‌خواهید و فقط دقیقاً آنچه نیاز دارید را فعال می‌کنید.

پیش‌فرض‌های خوب:

برای بیشتر کاربران اولین بار: یک ارائه‌دهنده انتخاب کنید، مقادیر پیش‌فرض را بپذیرید مگر اینکه بدانید چرا آن‌ها را تغییر می‌دهید. فهرست کامل ارائه‌دهندگان با متغیرهای محیطی و مراحل تنظیم در صفحه ارائه‌دهندگان AI است.

Hermes Agent به یک مدل با حداقل ۶۴,۰۰۰ توکن context نیاز دارد. مدل‌هایی با پنجره کوچکتر نمی‌توانند حافظه کاری کافی برای گردش‌های کاری فراخوانی ابزار چندمرحله‌ای حفظ کنند و در شروع رد خواهند شد. بیشتر مدل‌های میزبانی‌شده (Claude، GPT، Gemini، Qwen، DeepSeek) به راحتی این را برآورده می‌کنند. اگر یک مدل محلی اجرا می‌کنید، اندازه context آن را حداقل ۶۴K تنظیم کنید (مثلاً --ctx-size 65536 برای llama.cpp یا -c 65536 برای Ollama).

می‌توانید هر زمان با hermes model ارائه‌دهنده را عوض کنید — بدون قفل شدن. برای فهرست کامل همه ارائه‌دهندگان پشتیبانی‌شده و جزئیات تنظیم، ارائه‌دهندگان AI را ببینید.

نحوه ذخیره تنظیمات

Hermes رمزها را از پیکربندی عادی جدا می‌کند:

• رمزها و توکن‌ها → ~/.hermes/.env
• تنظیمات غیر رمز → ~/.hermes/config.yaml

ساده‌ترین راه برای تنظیم مقادیر به طور صحیح از طریق CLI است:

hermes config set model anthropic/claude-opus-4.6
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-...

مقدار صحیح به طور خودکار به فایل صحیح هدایت می‌شود.

۳. اولین چت خود را اجرا کنید

hermes            # CLI کلاسیک
hermes --tui      # TUI مدرن (توصیه‌شده)

یک بنر خوش‌آمدگویی با مدل، ابزارهای موجود و skillهای خود خواهید دید. از یک پرامپت خاص و آسان برای تأیید استفاده کنید:

Hermes با دو رابط ترمینال ارائه می‌شود: CLI prompt_toolkit کلاسیک و یک TUI جدیدتر با overlayهای modal، انتخاب با ماوس و ورودی non-blocking. هر دو sessionها، فرمان‌های اسلش و پیکربندی مشترکی دارند — هر کدام را با hermes در مقابل hermes --tui امتحان کنید.

Summarize this repo in 5 bullets and tell me what the main entrypoint is.

Check my current directory and tell me what looks like the main project file.

Help me set up a clean GitHub PR workflow for this codebase.

چه چیزی موفقیت است:

• بنر مدل/ارائه‌دهنده انتخابی شما را نشان می‌دهد
• Hermes بدون خطا پاسخ می‌دهد
• می‌تواند در صورت نیاز از یک ابزار استفاده کند (ترمینال، خواندن فایل، جستجوی وب)
• مکالمه به طور عادی بیش از یک نوبت ادامه می‌یابد

اگر این کار کرد، از سخت‌ترین قسمت عبور کرده‌اید.

۴. تأیید کار Sessionها

قبل از ادامه، مطمئن شوید از سرگیری کار می‌کند:

hermes --continue    # از سرگیری آخرین session
hermes -c            # فرم کوتاه

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

۵. ویژگی‌های کلیدی را امتحان کنید

استفاده از ترمینال

❯ What's my disk usage? Show the top 5 largest directories.

agent به نیابت شما فرمان‌های ترمینال را اجرا می‌کند و نتایج را نشان می‌دهد.

فرمان‌های اسلش

/ را تایپ کنید تا کشویی autocomplete تمام فرمان‌ها را ببینید:

ورودی چند خطی

Alt+Enter، Ctrl+J یا Shift+Enter را فشار دهید تا یک خط جدید اضافه شود. Shift+Enter نیاز به ترمینالی دارد که آن را به عنوان توالی متمایز ارسال کند (Kitty / foot / WezTerm / Ghostty به طور پیش‌فرض؛ iTerm2 / Alacritty / ترمینال VS Code وقتی پروتکل کیبورد Kitty فعال باشد). Alt+Enter و Ctrl+J در هر ترمینالی کار می‌کنند.

متوقف کردن agent

اگر agent خیلی طول می‌کشد، یک پیام جدید تایپ کنید و Enter را فشار دهید — وظیفه فعلی را قطع می‌کند و به دستورالعمل‌های جدید شما سوئیچ می‌کند. Ctrl+C هم کار می‌کند.

۶. لایه بعدی را اضافه کنید

فقط بعد از کار چت پایه. آنچه نیاز دارید را انتخاب کنید:

ربات یا دستیار مشترک

hermes gateway setup    # پیکربندی تعاملی پلتفرم

Telegram، Discord، Slack، WhatsApp، Signal، Email، Home Assistant یا Microsoft Teams را وصل کنید.

اتوماسیون و ابزارها

• hermes tools — دسترسی ابزار را به ازای هر پلتفرم تنظیم کنید
• hermes skills — workflowهای قابل استفاده مجدد را مرور و نصب کنید
• Cron — فقط بعد از پایداری نصب ربات یا CLI شما

ترمینال sandboxed

برای ایمنی، agent را در یک کانتینر Docker یا روی یک سرور راه‌دور اجرا کنید:

hermes config set terminal.backend docker    # ایزولاسیون Docker
hermes config set terminal.backend ssh       # سرور راه‌دور

حالت صوتی

# از دایرکتوری نصب Hermes (نصب‌کننده curl آن را در
# ~/.hermes/hermes-agent در Linux/macOS یا %LOCALAPPDATA%\hermes\hermes-agent در Windows قرار داده):
cd ~/.hermes/hermes-agent
uv pip install -e ".[voice]"
# شامل faster-whisper برای تبدیل رایگان گفتار به متن محلی

سپس در CLI: /voice on. Ctrl+B را برای ضبط فشار دهید. حالت صوتی را ببینید.

Skillها

Skillها اسناد دستورالعمل on-demand هستند که به Hermes یاد می‌دهند چگونه یک کار خاص را انجام دهد — استقرار در Kubernetes، باز کردن یک PR GitHub، تنظیم دقیق مدل، جستجوی GIF. هر کدام یک فایل SKILL.md با نام، توضیح و روش گام‌به‌گام هستند. agent توضیحات کوتاه را به طور رایگان می‌خواند و فقط محتوای کامل skill را وقتی بارگذاری می‌کند که واقعاً یک کار به آن نیاز دارد، بنابراین اضافه کردن skillها هر درخواست را حجیم نمی‌کند.

Hermes با فهرستی از skillهای بسته‌بندی‌شده که قبلاً در ~/.hermes/skills/ نصب شده‌اند ارائه می‌شود. می‌توانید از Skills Hub بیشتر اضافه کنید یا خودتان بنویسید.

از hub مرور و نصب کنید:

hermes skills browse                      # لیست همه موجود
hermes skills search kubernetes           # جستجوی skillها با کلمه کلیدی
hermes skills install openai/skills/k8s   # نصب یکی (ابتدا اسکن امنیتی اجرا می‌کند)

هر skill نصب‌شده به طور خودکار به عنوان یک فرمان اسلش تبدیل می‌شود:

/k8s deploy the staging manifest          # اجرای skill با یک درخواست
/k8s                                       # بارگذاری آن و اجازه دهید Hermes بپرسد چه نیاز دارید

این در CLI و هر پلتفرم پیام‌رسانی متصل کار می‌کند. لازم نیست همه چیز را از قبل نصب کنید — agent در حین مکالمه عادی skill بسته‌بندی‌شده صحیح را وقتی یک کار با آن مطابقت دارد به طور خودکار انتخاب می‌کند.

سیستم Skillها را برای نوشتن skillهای خود، دایرکتوری‌های skill خارجی و فهرست کامل منابع hub ببینید.

سرورهای MCP

# به ~/.hermes/config.yaml اضافه کنید
mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

ادغام ویرایشگر (ACP)

پشتیبانی ACP با اکستراهای استاندارد [all] ارائه می‌شود، بنابراین نصب‌کننده curl آن را از قبل شامل می‌شود. فقط اجرا کنید:

hermes acp

(اگر بدون [all] نصب کرده‌اید، ابتدا cd ~/.hermes/hermes-agent && uv pip install -e ".[acp]" را اجرا کنید.)

ادغام ویرایشگر ACP را ببینید.

حالت‌های خرابی رایج

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

کیت بازیابی

وقتی چیزی اشتباه به نظر می‌رسد، از این ترتیب استفاده کنید:

1. hermes doctor
2. hermes model
3. hermes setup
4. hermes sessions list
5. hermes --continue
6. hermes gateway status

آن ترتیب شما را از «حس خرابی» به یک وضعیت شناخته‌شده سریع برمی‌گرداند.

مرجع سریع

قدم‌های بعدی

• راهنمای CLI — تسلط بر رابط ترمینال
• پیکربندی — سفارشی‌سازی تنظیمات
• Gateway پیام‌رسانی — اتصال Telegram، Discord، Slack، WhatsApp، Signal، Email، Home Assistant، Teams و بیشتر
• ابزارها و مجموعه ابزارها — کاوش قابلیت‌های موجود
• ارائه‌دهندگان AI — فهرست کامل ارائه‌دهندگان و جزئیات تنظیم
• سیستم Skillها — workflowها و دانش قابل استفاده مجدد
• نکات و بهترین شیوه‌ها — نکات کاربر حرفه‌ای

Edit this page