می‌توانید از ما نخرید!
آموزش کامل، فنی و صفر تا صد راه‌اندازی شخصی هرمس ایجنت روی سرور خودتان
ما معتقدیم حق شماست که بدانید پشت صحنه چه می‌گذرد. هرمس کاملاً متن‌باز است. در این مستند جامع، تمامی ۸ مرحله طاقت‌فرسا، دستورات لینوکس، کدهای ترمینال، کانفیگ‌های شبکه و تانل‌های ضدتحریم را مو به مو نوشته‌ایم تا اگر خواستید، همه کارها را خودتان انجام دهید.
توجه: این مراحل شامل تغییرات حساس سیستمی (سوآپ لینوکس، روتینگ پروکسی سراسری، پورت‌های شبکه و سوکت‌های سیستمی) است. اجرای خودکار یا نسنجیده این فرآیندها توسط اسکریپت‌ها، به دلیل ریسک مسدود شدن پورت SSH، اختلال کامل در DNS سرور، پر شدن رم و بن شدن اکانت‌های هوش مصنوعی نیازمند تسلط کامل به لینوکس و شبکه است. در صورت بروز هرگونه قطعی یا کرش سیستم‌عامل، مسئولیت نگهداری مستقیماً بر عهده خود کاربر است.
خرید و آماده‌سازی سرور لینوکس ابری (VPS)
برای شروع، حداقل به یک سرور ابری اوبونتو (ترجیحاً Ubuntu 22.04 LTS) با حداقل ۱ یا ۲ گیگابایت رم نیاز دارید. هزینه اجاره ماهانه این سرور در دیتاسنترها حداقل ۵۰۰ تا ۷۰۰ هزار تومان در ماه است. بعد از خرید، باید سرور را با پکیج‌های پایه پایتون، کامپایلرهای C++ و سوآپ رم آماده کنید (توجه: به دلیل تفاوت در مجازی‌سازی سرورها مانند KVM یا OpenVZ و تفاوت معماری کرنل لینوکس، مقادیر Swap و مسیر پکیج‌ها باید توسط مدیر سرور به صورت دستی بررسی شود و اجرای اتوماتیک یا نابینای اسکریپتی به هیچ وجه توصیه نمی‌شود):
sudo fallocate -l 2G /swapfile && sudo chmod 600 /swapfile && sudo mkswap /swapfile && sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
دور زدن تحریم‌های دوطرفه و فیلترینگ شدید (سخت‌ترین مرحله)
شرکت‌های OpenAI، Anthropic (Claude) و Google Cloud آی‌پی‌های سرورهای ایران را کاملاً مسدود و بلاک کرده‌اند. از آن سو، رگولاتوری ایران نیز پروتکل‌های مستقیم را فیلتر می‌کند. شما باید یک ورکر کلودفلر یا رله اختصاصی در Vercel ایجاد کنید یا یک کلاینت ضدسانسور Sing-box روی پورت لوکال ران کنید و ترافیک پایتون را با پروکسی فوروارد نمایید:
export HTTPS_PROXY="socks5://127.0.0.1:10808"
curl -I --proxy socks5://127.0.0.1:10808 https://api.anthropic.com/v1/messages
هشدار: در صورت هرگونه قطع اتصال اینترنت بین‌الملل، فیلترینگ دامنه‌ها یا تغییر قوانین SNI، ایجنت شما متوقف شده و با خطای Connection Timeout یا 403 Forbidden روبرو خواهید شد.
برای ارتباط سرور با هوش مصنوعی معمولاً به VPN نیاز است؛ اما با استفاده از ورکر کلودفلر (Cloudflare Worker) می‌توانید یک پروکسی رله معکوس و کاملاً رایگان ایجاد کنید تا بدون نیاز به فیلترشکن و درگیر شدن با قطعی‌های مداوم، ترافیک مدل‌ها را عبور دهید. مستندات و کد این ابزار:
خرید اکانت هوش مصنوعی و اتصال به ۹روتر
برای کار با هرمس، باید مدل هوش مصنوعی داشته باشید و آن را به ۹روتر متصل کنید. برای این کار پیشنهاد ما خرید اکانت گوگل جمینای (Gemini) است. مراحل تهیه، تغییر ریجن و رفع خطاهای احراز هویت:
پیشنهاد ما تهیه اکانت جمینای از ربات تلگرامی زیر است. با کد تخفیف اختصاصی mrhermes می‌توانید اکانت خود را دریافت کنید:
اگر ریجن اکانت جیمیل فعلی شما ایران است، دسترسی مستقیم مسدود است و باید طبق آموزش اختصاصی زیر، به گوگل درخواست تغییر ریجن ثبت کنید:
نکته جایگزین: اگر با تغییر ریجن موافقت نشد، می‌توانید یک جیمیل آماده خارجی از همان ربات (googleaiaccbot) خریداری کنید، سپس جمینای را روی آن فعال کرده و در ۹روتر استفاده نمایید.
امکان دارد اکانت گوگل درخواست وریفای و تایید هویت بدهد. برای حل این مشکل، نسخه آنتی‌گرویتی را از لینک زیر نصب کنید:
- فرآیند تایید فیزیکی: پس از مشاهده خطای وریفای، روی لینک آن کلیک کرده تا کد QR نمایش داده شود. آن را حتماً باید دستی با دوربین گوشی اسکن و تایید دو مرحله‌ای (2FA) را ثبت نمایید (این بخش توسط هیچ اسکریپت، ربات یا هوش مصنوعی به صورت هدلس روی سرور قابل اجرا نیست و نیاز به دخالت مستقیم شخص دارد).
- تایید شماره موبایل: اگر یک شماره موبایل را قبول نکرد، فرآیند را با سیم‌کارت و موبایل شخص دیگری تست کنید.
- عدم دریافت لینک وریفای: چنانچه اصلاً لینک وریفای نیامد یا صفحه باز نشد، اختلال ناشی از IP یا فیلترشکن شماست و باید سرور یا اتصال VPN را تغییر دهید.
نصب و کامپایل هسته هرمس ایجنت (Hermes Agent)
باید به مستندات رسمی نوس ریسرچ به آدرس hermes-agent.nousresearch.com مراجعه کرده و هسته پایتونی هرمس را در یک محیط مجازی ایزوله کامپایل و نصب نمایید:
cd hermes-agent && python3 -m venv venv
./venv/bin/pip install --upgrade pip setuptools wheel
./venv/bin/pip install -e .
دانلود و پیکربندی ۹روتر (9Router) جهت مدیریت مدل‌ها
استفاده مستقیم از یک مدل باعث پر شدن سهمیه توکن (Rate Limit 429) و توقف تسک‌های شما می‌شود. برای مدیریت چند اکانت و فال‌بک خودکار بین مدل‌های استدلال‌گر Claude 3.7 و Gemini 3.8، باید ۹روتر را از وب‌سایت 9router.com دانلود و در لایه زیرساخت با یک باینری یا Docker اجرا نمایید:
9router --port 20128 --admin-key "YOUR_SECRET_KEY" --daemon
راهنمایی و سوالات ۹روتر: جهت حل سوالات و کانفیگ می‌توانید به کانال و گروه تلگرام @the9router مراجعه نمایید.
اتصال ۹روتر به هسته هرمس به عنوان Custom Provider
باید کانفیگ فایل ~/.hermes/config.yaml را به صورت دستی باز کرده و اندپوینت‌های OpenAI-compatible ۹روتر را به همراه توکن‌های سشن OAuth و کلید احراز هویت داخلی به هرمس بشناسانید. از آنجا که توکن‌های ارائه‌دهنده به صورت دوره‌ای منقضی می‌شوند و نیاز به Refresh دستی دارند، پیکربندی هرمس در این بخش کاملاً به توکن‌های تولیدشده در مرورگر شخصی وابسته است:
custom_providers:
9router:
base_url: "http://127.0.0.1:20128/v1"
api_key: "YOUR_DYNAMIC_SESSION_KEY"
دانلود، بیلد و اجرای Hermes WebUI
برای داشتن محیط چت در مرورگر، باید رابط کاربری وب را از گیت‌هاب رسمی github.com/nesquena/hermes-webui کلون کنید، وب‌سوکت‌ها، سرور پایتون و سرویس‌های Systemd را تنظیم نمایید:
python3 /opt/hermes-webui/bootstrap.py --host 127.0.0.1 8788
امن‌سازی سرور، نوشتن کرون‌جاب واچ‌داگ و نگهداری مداوم
در پایان باید کانفیگ Nginx، پروتکل WebSocket با تایم‌اوت ۲۴ ساعته، دریافت گواهی SSL، امن‌سازی دسترسی‌های روت لینوکس (chmod 700) و اسکریپت واچ‌داگ بازگردانی خودکار سرویس‌ها در صورت قطعی یا پر شدن حافظه رم را بنویسید:
*/5 * * * * /usr/local/bin/stack-watchdog.sh >> /var/log/watchdog.log 2>&1
در هر مرحله از نصب شخصی، در صورت بروز سوال یا مشکل فنی می‌توانید از کامیونیتی‌ها و گروه‌های تخصصی زیر کمک بگیرید:
نتیجه‌گیری کاملاً صادقانه و بی‌پرده
اگر دانش عمیق لینوکس و دواپس دارید، حداقل ماهی ۵۰۰ هزار تا ۱ میلیون تومان برای سرور و وی‌پی‌ان هزینه می‌کنید، کارت اعتباری بین‌المللی برای پرداخت دلاری مدل‌ها دارید و حوصله سر و کله زدن روزانه با ارورهای ترمینال، قطعی فیلترشکن، ارور ۴۲۹ و کرش سرور را دارید:
شما هیچ نیازی به خرید از ما ندارید و می‌توانید همه این کارها را خودتان انجام دهید!
اما اگر حال و حوصله این همه دردسر فنی، بی‌خوابی برای دیباگ و هزینه‌های پراکنده را ندارید و می‌خواهید یک دستیار فوق‌هوشمند با پایداری تضمین‌شده، پشتیبانی فنی و دسترسی فوری در اختیارتان باشد: