Hermes Agent چیست؟ آموزش نصب امن در ویندوز و راه‌اندازی اولین عامل شخصی

Hermes Agent یک عامل هوش مصنوعی متن‌باز از Nous Research است که فقط به پاسخ‌دادن در یک پنجره چت محدود نمی‌شود. این ابزار می‌تواند در ترمینال کار کند، فایل بخواند، از ابزارهای مختلف استفاده کند، رویه‌های تکراری را به شکل Skill نگه دارد و بخشی از Context مفید را میان نشست‌ها حفظ کند. همین قدرت باعث می‌شود شیوه نصب و تعیین مرز دسترسی‌ها مهم‌تر از انتخاب یک Prompt جذاب باشد.

در این راهنما ابتدا تفاوت Hermes با یک چت‌بات معمولی را روشن می‌کنیم، سپس آن را در ویندوز نصب می‌کنیم، Provider و رابط TUI را راه می‌اندازیم و در پایان یک الگوی امن برای Memory، Skills و اجرای فرمان‌ها می‌سازیم. هدف این است که اولین تجربه شما هم کاربردی باشد و هم از ابتدا اصل کمترین دسترسی را رعایت کند.

Hermes Agent چیست و چه مسئله‌ای را حل می‌کند؟

در یک چت‌بات عادی، شما سؤال می‌پرسید و مدل متن تولید می‌کند. عامل هوش مصنوعی علاوه بر مدل، حلقه‌ای برای برنامه‌ریزی، فراخوانی ابزار، مشاهده نتیجه و ادامه کار دارد. Hermes این حلقه را با ابزارهای ترمینال و فایل، مرور وب، Memory، Skills، نشست‌های قابل ادامه و اتصال به Providerهای مختلف ترکیب می‌کند.

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

Hermes Agent با Copilot و چت‌بات چه تفاوتی دارد؟

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

پیش‌نیازها و انتخاب روش نصب

مستندات رسمی، ویندوز ۱۰ و ۱۱ را در معماری x86_64 و arm64 در سطح پشتیبانی اصلی قرار می‌دهند. برای ویندوز دو مسیر وجود دارد: Hermes Desktop برای تجربه گرافیکی و Installer رسمی PowerShell برای CLI. نصب Native داده‌ها را زیر %LOCALAPPDATA%\hermes نگه می‌دارد و به WSL وابسته نیست. اگر Workflow شما کاملاً لینوکسی است، WSL2 نیز مسیر رسمی جداگانه‌ای دارد.

• برای کاربر تازه‌کار و مدیریت بصری، Desktop مناسب‌تر است.
• برای توسعه‌دهنده‌ای که از Terminal استفاده می‌کند، نصب Native CLI مسیر مستقیم‌تری است.
• برای ابزارها و Scriptهای صرفاً POSIX، نسخه WSL2 اصطکاک کمتری دارد.
• برای محیط Production یا اجرای غیرقابل‌اعتماد، Backend ایزوله مانند Docker انتخاب بهتری است.

پیش از اجرا، صفحه Installation رسمی و Script مقصد را بازبینی کنید. فرمان Pipe-to-shell راحت است، اما باید فقط از دامنه رسمی و اتصال HTTPS گرفته شود. در محیط سازمانی بهتر است Script را ابتدا دانلود، Hash و محتوای آن را Review و سپس اجرا کنید.

نصب Hermes Agent در ویندوز

روش اول: نصب Native با PowerShell

PowerShell معمولی را باز کنید؛ طبق راهنمای رسمی نیازی به Administrator نیست. فرمان زیر Installer رسمی را دریافت و اجرا می‌کند. پس از پایان، Terminal جدیدی باز کنید تا PATH کاربر تازه شود.

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

hermes doctor برای تشخیص Dependency یا PATH مفید است. Installer رسمی در صورت نیاز Python و ابزارهای همراه را در محدوده کاربر آماده می‌کند. اگر Terminal فرمان hermes را پیدا نکرد، ابتدا پنجره را ببندید و یک Terminal تازه باز کنید؛ تغییر دستی PATH باید آخرین گزینه باشد.

روش دوم: Hermes Desktop

Desktop از همان Runtime، تنظیمات، نشست‌ها، Skills و Memory نسخه CLI استفاده می‌کند. بنابراین می‌توانید یک نشست را در برنامه Desktop شروع و در CLI ادامه دهید. فایل Installer را فقط از وب‌سایت رسمی دریافت کنید و Publisher، دامنه و نسخه را پیش از اجرا بررسی کنید.

راه‌اندازی Provider و اولین نشست

Hermes خود مدل نیست؛ برای تولید پاسخ به یک Provider یا مدل محلی نیاز دارد. مستندات رسمی، Nous Portal، OpenRouter، OpenAI، Anthropic، Google و Endpointهای سازگار با OpenAI را پوشش می‌دهند. انتخاب Provider به بودجه، سیاست نگه‌داری داده، دسترسی منطقه‌ای و مدل موردنیاز شما بستگی دارد.

برای تنظیم تعاملی از hermes setup استفاده کنید. مسیر سریع رسمی برای Portal، فرمان hermes setup --portal است. Credential را داخل Prompt، فایل پروژه یا History شِل کپی نکنید؛ از Flow احراز هویت یا فایل تنظیمات امن خود ابزار استفاده کنید.

hermes setup --portalhermes --tuihermes --tui --continue

رابط TUI برای استفاده تعاملی پیشنهاد شده است. گزینه --continue آخرین نشست را ادامه می‌دهد. در اولین گفتگو یک کار خواندنی و کم‌ریسک بدهید؛ مثلاً از عامل بخواهید ساختار یک پوشه آزمایشی را خلاصه کند، بدون اینکه فایلی را ویرایش یا فرمانی را اجرا کند.

Toolset را با کمترین دسترسی فعال کنید

ابزارها قدرت عملی عامل را می‌سازند. دسترسی به فایل، Terminal، Browser یا Messaging نباید فقط به دلیل موجودبودن فعال شود. ابتدا Use Case را تعریف کنید و فقط Toolset لازم را باز کنید. برای مرور مستندات، دسترسی Browser کافی است؛ برای Review کد، خواندن Repository لازم است اما نوشتن یا Network گسترده شاید لازم نباشد.

1. یک پوشه آزمایشی جدا از پروژه‌های حساس بسازید.
2. عامل را از همان پوشه اجرا کنید.
3. در شروع فقط عملیات خواندنی را مجاز کنید.
4. فرمان‌های پیشنهادی را پیش از تأیید بخوانید.
5. Secretها و فایل‌های Environment را از Scope خارج کنید.
6. پس از هر تغییر، Diff و نتیجه Test را مستقل بررسی کنید.

مستندات امنیتی Hermes حالت smart را برای Approval پیش‌فرض معرفی می‌کنند. حالت off یا --yolo کنترل تأیید را حذف می‌کند و برای محیط روزمره توصیه نمی‌شود. اجرای خودکار بدون حضور کاربر باید Fail-closed باشد؛ یعنی فرمان خطرناک در نبود تأیید متوقف شود.

تنظیم Approval امن

نمونه زیر یک نقطه شروع محافظه‌کارانه است: فرمان خطرناک با ارزیابی هوشمند یا تأیید کاربر کنترل می‌شود و کارهای زمان‌بندی‌شده، تک‌پرسشی و بدون حضور کاربر اجازه عبور خودکار ندارند.

approvals:  mode: smart  timeout: 300  cron_mode: deny  single_query_mode: deny  unattended_mode: deny

Allowlist دائمی را با احتیاط بسازید. یک فرمانی که امروز برای پروژه آزمایشی بی‌خطر است ممکن است فردا در Working Directory دیگری مخرب باشد. به‌جای مجازکردن یک ابزار کلی، الگوی محدود و قابل‌فهم انتخاب کنید. برای کار حساس، Backend ایزوله مانند Docker مرز قوی‌تری از یک Prompt یا Allowlist فراهم می‌کند.

Memory و Skills چه تفاوتی دارند؟

Memory برای نگه‌داشتن واقعیت‌های مفید درباره کاربر، پروژه و ترجیح‌هاست؛ Skills رویه انجام کار را ذخیره می‌کنند. برای مثال «این پروژه از .NET استفاده می‌کند» یک واقعیت است، اما «مراحل انتشار نسخه» یک Skill است. مخلوط‌کردن این دو باعث می‌شود Context شلوغ و رفتار عامل غیرقابل‌پیش‌بینی شود.

قانون ساده برای ذخیره‌سازی

• اطلاعات موقت یا Secret را در Memory ذخیره نکنید.
• Preference پایدار و غیرحساس می‌تواند Memory باشد.
• رویه‌ای که باید Review و Version شود، Skill است.
• Skill دانلودشده را مانند کد شخص ثالث بازبینی کنید.
• برای نوشته‌های خودکار Memory و Skill می‌توانید Approval نوشتن را فعال کنید.

Hermes از Memory داخلی استفاده می‌کند و Providerهای خارجی را به صورت اختیاری می‌پذیرد. فعال‌کردن Provider خارجی یعنی بخشی از Context ممکن است به سرویس دیگری برود؛ پیش از انتخاب، محل ذخیره‌سازی، هزینه، حذف داده و سیاست Privacy آن سرویس را بررسی کنید.

ساخت اولین Workflow واقعی

برای اولین پروژه، هدفی انتخاب کنید که خروجی آن به‌سادگی قابل راستی‌آزمایی باشد. نمونه مناسب، تهیه گزارش Read-only از یک Repository آزمایشی است: زبان‌ها، فایل‌های Entry point، فرمان Test موجود و ریسک‌های آشکار. از عامل بخواهید پیش از هر Write یا اجرای فرمان اجازه بگیرد و نتیجه را با مسیر فایل مستند کند.

1. Repository نمونه را در پوشه جدا Clone کنید.
2. یک نشست تازه Hermes را در همان مسیر باز کنید.
3. Scope را صریح بگویید: فقط خواندن و گزارش.
4. از عامل بخواهید Plan کوتاه ارائه دهد.
5. هر Tool call را با هدف Plan مقایسه کنید.
6. گزارش را با فایل‌های واقعی تطبیق دهید.
7. تنها پس از موفقیت، یک تغییر کوچک و قابل بازگشت بسپارید.

اگر این Workflow تکرار می‌شود، مراحل پایدار آن را به Skill تبدیل کنید؛ اما Project-specific Secret، Token یا مسیر شخصی را در Skill قرار ندهید. برای طراحی دستورالعمل قابل‌انتقال می‌توانید راهنمای Agent Skills و فایل SKILL.md را بخوانید.

رفع خطاهای رایج

برای عیب‌یابی، ابتدا نسخه، مسیر نصب و خروجی hermes doctor را ثبت کنید؛ ولی قبل از اشتراک‌گذاری Log، Token، مسیر شخصی و محتوای خصوصی را حذف کنید. مستندات رسمی Platform Support تفاوت Native Windows، WSL2 و قابلیت‌های هر محیط را توضیح می‌دهند.

چک‌لیست امنیت پیش از استفاده روزمره

• Installer فقط از منبع رسمی دریافت شده است.
• Provider و سیاست ارسال داده مشخص است.
• Credential داخل Prompt یا Repository نیست.
• Working Directory به پروژه موردنیاز محدود است.
• Approval روی smart یا manual قرار دارد.
• حالت‌های Cron و Unattended برای عملیات خطرناک deny هستند.
• فایل‌های Secret و Environment خارج از Scope هستند.
• هر Skill شخص ثالث پیش از فعال‌شدن Review شده است.
• Memory فقط اطلاعات پایدار و غیرحساس را نگه می‌دارد.
• برای کار پرریسک از Container یا محیط جدا استفاده می‌شود.
• Diff، Test و خروجی نهایی مستقل بررسی می‌شوند.

جمع‌بندی

Hermes Agent برای کسی جذاب است که عامل شخصی را فراتر از یک IDE می‌خواهد: مدل قابل انتخاب، ابزارهای متعدد، Memory، Skills و نشست‌هایی که میان CLI، TUI و Desktop ادامه پیدا می‌کنند. ارزش واقعی آن زمانی آشکار می‌شود که یک Workflow تکراری را با Context درست و مرزهای فنی روشن اجرا کند.

شروع مناسب، نصب محدود به کاربر، تنظیم Provider، اجرای TUI و یک کار Read-only در پوشه آزمایشی است. پس از اطمینان، Toolset و نوشتن را مرحله‌ای اضافه کنید. Approval، Sandbox و Review خروجی را بخشی از طراحی بدانید، نه مانعی که باید خاموش شود.

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

منابع رسمی

• مستندات رسمی Hermes Agent
• راهنمای رسمی نصب
• پشتیبانی پلتفرم‌ها
• مدل امنیت و Approvalها
• سیستم Skills
• Memory Providerها