ہرمیس ایجنٹ ☤ (Hermes Agent)

نوس ریسرچ (Nous Research) کا تیار کردہ خود کو بہتر بنانے والا اے آئی (AI) ایجنٹ۔ یہ واحد ایجنٹ ہے جس میں سیکھنے کا عمل (learning loop) پہلے سے موجود ہے — یہ اپنے تجربات سے نئی مہارتیں (skills) بناتا ہے، استعمال کے دوران ان کو بہتر کرتا ہے، معلومات کو محفوظ رکھنے کے لیے خود کو یاد دہانی کرواتا ہے، اپنی پرانی بات چیت کو تلاش کر سکتا ہے، اور مختلف سیشنز کے دوران آپ کے بارے میں ایک گہری سمجھ پیدا کرتا ہے۔ اسے $5 والے VPS پر چلائیں، GPU کلسٹر پر، یا سرور لیس (serverless) انفراسٹرکچر پر جس کی قیمت استعمال نہ ہونے پر تقریباً صفر ہے۔ یہ آپ کے لیپ ٹاپ تک محدود نہیں ہے — آپ ٹیلی گرام (Telegram) سے اس کے ساتھ بات چیت کر سکتے ہیں جبکہ یہ کلاؤڈ VM پر کام کر رہا ہو۔

آپ اپنی مرضی کا کوئی بھی ماڈل استعمال کر سکتے ہیں — Nous Portal، OpenRouter (200 سے زائد ماڈلز)، NovitaAI (ماڈل API، ایجنٹ سینڈ باکس، اور GPU کلاؤڈ کے لیے اے آئی مقامی کلاؤڈ)، NVIDIA NIM (Nemotron)، Xiaomi MiMo، z.ai/GLM، Kimi/Moonshot، MiniMax، Hugging Face، OpenAI، یا اپنا حسب ضرورت اینڈ پوائنٹ (endpoint) استعمال کریں۔ ماڈل تبدیل کرنے کے لیے صرف hermes model استعمال کریں — کسی کوڈ کو تبدیل کرنے کی ضرورت نہیں، کوئی پابندی نہیں۔

<table> <tr><td><b>حقیقی ٹرمینل انٹرفیس</b></td><td>مکمل TUI جس میں ملٹی لائن ایڈیٹنگ، سلیش-کمانڈ آٹو کمپلیٹ، بات چیت کی ہسٹری، انٹرپٹ اور ری ڈائریکٹ، اور سٹریمنگ ٹول آؤٹ پٹ شامل ہے۔</td></tr> <tr><td><b>یہ وہاں موجود ہے جہاں آپ ہیں</b></td><td>ٹیلی گرام، ڈسکارڈ (Discord)، سلیک (Slack)، واٹس ایپ (WhatsApp)، سگنل (Signal)، اور CLI — سب ایک ہی گیٹ وے پروسیس سے کام کرتے ہیں۔ وائس میمو (Voice memo) ٹرانسکرپشن، کراس پلیٹ فارم بات چیت کا تسلسل۔</td></tr> <tr><td><b>سیکھنے کا ایک مکمل عمل</b></td><td>ایجنٹ کی اپنی ترتیب دی گئی میموری، جس میں وہ خود کو وقتاً فوقتاً یاد دہانی کرواتا ہے۔ پیچیدہ کاموں کے بعد خود کار طریقے سے مہارت (skill) کی تخلیق۔ استعمال کے دوران مہارتوں میں بہتری۔ LLM سمرائزیشن کے ساتھ FTS5 سیشن سرچ تاکہ پرانے سیشنز کی یاددہانی کی جا سکے۔ <a href="https://github.com/plastic-labs/honcho">Honcho</a> کے ذریعے صارف کی ماڈلنگ۔ <a href="https://agentskills.io">agentskills.io</a> اوپن سٹینڈرڈ کے ساتھ مکمل مطابقت۔</td></tr> <tr><td><b>شیڈول کی گئی خودکار کارروائیاں</b></td><td>بلٹ ان (Built-in) کرون (cron) شیڈیولر جو کسی بھی پلیٹ فارم پر ڈیلیوری کے لیے استعمال ہو سکتا ہے۔ روزانہ کی رپورٹس، رات کے بیک اپس، ہفتہ وار آڈٹس — یہ سب کچھ قدرتی زبان (natural language) میں اور بغیر کسی نگرانی کے کام کرتا ہے۔</td></tr> <tr><td><b>کام کی تقسیم اور متوازی عمل</b></td><td>متوازی (parallel) کاموں کے لیے الگ سے ذیلی ایجنٹس (subagents) بنائیں۔ پائتھون (Python) سکرپٹس لکھیں جو RPC کے ذریعے ٹولز کو استعمال کریں، تاکہ کئی مراحل پر مشتمل کاموں کو بغیر کسی سیاق و سباق (context) کے خرچ کے، ایک ہی باری میں انجام دیا جا سکے۔</td></tr> <tr><td><b>کہیں بھی چلائیں، صرف اپنے لیپ ٹاپ پر نہیں</b></td><td>چھ (Six) ٹرمینل بیک اینڈز — لوکل، Docker، SSH، Singularity، Modal، اور Daytona۔ ڈیٹونا (Daytona) اور موڈل (Modal) سرور لیس (serverless) فعالیت پیش کرتے ہیں — جب آپ کا ایجنٹ فارغ ہوتا ہے تو اس کا ماحول سلیپ (hibernate) ہو جاتا ہے اور ضرورت پڑنے پر خود بخود جاگ جاتا ہے، جس کی وجہ سے سیشنز کے درمیان لاگت تقریباً صفر رہتی ہے۔ اسے $5 والے VPS یا GPU کلسٹر پر چلائیں۔</td></tr> <tr><td><b>تحقیق کے لیے تیار</b></td><td>بیچ (Batch) ٹریجیکٹری (trajectory) جنریشن، اگلی نسل کے ٹول کالنگ ماڈلز کی تربیت کے لیے ٹریجیکٹری کمپریشن۔</td></tr> </table>

فوری انسٹالیشن (Quick Install)

لینکس (Linux)، میک او ایس (macOS)، ڈبلیو ایس ایل ٹو (WSL2)، ٹرمکس (Termux)

bash

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

</div>

ونڈوز (نیٹو، پاور شیل)

توجہ فرمائیں: مقامی ونڈوز (Native Windows) پر ہرمیس بغیر WSL کے چلتا ہے — CLI، گیٹ وے، TUI، اور ٹولز سب مقامی طور پر کام کرتے ہیں۔ اگر آپ WSL2 استعمال کرنا پسند کرتے ہیں، تو اوپر دی گئی لینکس/میک او ایس کی کمانڈ وہاں بھی کام کرے گی۔ کوئی مسئلہ نظر آیا؟ براہ کرم مسائل (issues) درج کریں۔

اسے پاور شیل (PowerShell) میں چلائیں:

powershell

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

</div>

انسٹالر سب کچھ خود سنبھالتا ہے: uv، Python 3.11، Node.js، ripgrep، ffmpeg، اور ایک پورٹ ایبل (portable) گٹ بیش (Git Bash) (یعنی MinGit، جو %LOCALAPPDATA%\hermes\git میں ان پیک ہوتا ہے — اس کے لیے ایڈمن کی اجازت درکار نہیں، اور یہ سسٹم کے کسی بھی گٹ انسٹال سے بالکل الگ ہے)۔ ہرمیس اس بنڈل شدہ گٹ بیش کو شیل کمانڈز چلانے کے لیے استعمال کرتا ہے۔

اگر آپ کے پاس پہلے سے گٹ (Git) انسٹال ہے، تو انسٹالر اسے شناخت کر لیتا ہے اور اسے ہی استعمال کرتا ہے۔ بصورت دیگر آپ کو صرف ~45MB کے MinGit ڈاؤنلوڈ کی ضرورت ہوگی — یہ آپ کے سسٹم کے گٹ پر کوئی اثر نہیں ڈالے گا۔

اینڈرائیڈ (Android) / ٹرمکس (Termux): ٹیسٹ کیا گیا مینوئل طریقہ Termux گائیڈ میں موجود ہے۔ ٹرمکس پر ہرمیس ایک مخصوص .[termux] ایکسٹرا انسٹال کرتا ہے کیونکہ مکمل .[all] ایکسٹرا میں ایسی وائس ڈیپینڈینسیز شامل ہیں جو اینڈرائیڈ کے ساتھ مطابقت نہیں رکھتیں۔

ونڈوز (Windows): مقامی ونڈوز کی مکمل سپورٹ موجود ہے — اوپر دی گئی پاور شیل کی کمانڈ سب کچھ انسٹال کر دیتی ہے۔ اگر آپ WSL2 استعمال کرنا چاہتے ہیں، تو لینکس کی کمانڈ وہاں کام کرتی ہے۔ مقامی ونڈوز میں انسٹالیشن %LOCALAPPDATA%\hermes میں ہوتی ہے؛ جبکہ WSL2 میں لینکس کی طرح ~/.hermes میں ہوتی ہے۔ ہرمیس کا وہ واحد فیچر جسے فی الحال خاص طور پر WSL2 کی ضرورت ہے وہ براؤزر پر مبنی ڈیش بورڈ چیٹ پین ہے (یہ POSIX PTY استعمال کرتا ہے — کلاسک CLI اور گیٹ وے دونوں مقامی طور پر چلتے ہیں)۔

انسٹالیشن کے بعد:

bash

source ~/.bashrc    # شیل کو ری لوڈ کریں (یا: source ~/.zshrc)
hermes              # بات چیت شروع کریں!

</div>

آغاز کریں (Getting Started)

bash

hermes              # انٹرایکٹو CLI — بات چیت شروع کریں
hermes model        # اپنا LLM پرووائیڈر اور ماڈل منتخب کریں
hermes tools        # کنفیگر کریں کہ کون سے ٹولز ایکٹو ہیں
hermes config set   # انفرادی کنفگ (config) ویلیوز سیٹ کریں
hermes gateway      # میسجنگ گیٹ وے شروع کریں (ٹیلی گرام، ڈسکارڈ، وغیرہ)
hermes setup        # مکمل سیٹ اپ وزرڈ چلائیں (یہ سب کچھ ایک ساتھ کنفیگر کر دے گا)
hermes claw migrate # OpenClaw سے مائیگریٹ کریں (اگر آپ OpenClaw سے آ رہے ہیں)
hermes update       # لیٹسٹ ورژن پر اپ ڈیٹ کریں
hermes doctor       # کسی بھی مسئلے کی تشخیص کریں

</div>

📖 مکمل دستاویزات →

API-کیز اکٹھی کرنے سے بچیں — Nous Portal

ہرمیس آپ کے پسندیدہ پرووائیڈر کے ساتھ کام کرتا ہے — یہ چیز تبدیل نہیں ہو رہی۔ لیکن اگر آپ ماڈل، ویب سرچ، امیج جنریشن، TTS، اور کلاؤڈ براؤزر کے لیے پانچ الگ الگ API کیز جمع نہیں کرنا چاہتے، تو Nous Portal ان سب کو ایک ہی سبسکرپشن کے تحت کور کرتا ہے:

300+ ماڈلز — ان میں سے کوئی بھی ماڈل /model <name> کے ذریعے منتخب کریں
ٹول گیٹ وے (Tool Gateway) — ویب سرچ (Firecrawl)، امیج جنریشن (FAL)، ٹیکسٹ ٹو سپیچ (OpenAI)، کلاؤڈ براؤزر (Browser Use)، یہ سب آپ کی سبسکرپشن کے ذریعے چلتے ہیں۔ کسی اضافی اکاؤنٹ کی ضرورت نہیں۔

نئی انسٹالیشن کے بعد بس ایک کمانڈ کی ضرورت ہے:

bash

hermes setup --portal

</div>

یہ آپ کو OAuth کے ذریعے لاگ ان کرواتا ہے، Nous کو آپ کا پرووائیڈر مقرر کرتا ہے، اور ٹول گیٹ وے کو آن کر دیتا ہے۔ hermes portal info کمانڈ استعمال کر کے آپ کسی بھی وقت چیک کر سکتے ہیں کہ کون کون سی سروسز منسلک ہیں۔ مکمل تفصیلات Tool Gateway دستاویزات کے صفحے پر موجود ہیں۔

آپ اب بھی کسی بھی ٹول کے لیے اپنی مرضی کی API کیز استعمال کر سکتے ہیں — گیٹ وے ہر سروس کے لیے الگ الگ کام کرتا ہے، ایسا نہیں کہ یا تو سب کچھ استعمال کریں یا کچھ بھی نہیں۔

CLI بمقابلہ میسجنگ فوری حوالہ

ہرمیس کے دو بنیادی انٹر فیس ہیں: آپ ٹرمینل UI کو hermes کے ساتھ شروع کریں، یا گیٹ وے چلا کر اس کے ساتھ ٹیلی گرام، ڈسکارڈ، سلیک، واٹس ایپ، سگنل، یا ای میل کے ذریعے بات کریں۔ جب آپ کسی بات چیت میں ہوتے ہیں، تو بہت سی سلیش (slash) کمانڈز دونوں انٹرفیسز میں ایک جیسی ہوتی ہیں۔

کارروائی (Action)	سی ایل آئی (CLI)	میسجنگ پلیٹ فارمز (Messaging platforms)
بات چیت شروع کریں	`hermes`	`hermes gateway setup` اور `hermes gateway start` چلائیں، پھر بوٹ کو میسج بھیجیں
نئی بات چیت شروع کریں	`/new` یا `/reset`	`/new` یا `/reset`
ماڈل تبدیل کریں	`/model [provider:model]`	`/model [provider:model]`
پرسنلٹی (Personality) سیٹ کریں	`/personality [name]`	`/personality [name]`
پچھلی باری کو دوبارہ یا منسوخ (undo) کریں	`/retry`، `/undo`	`/retry`، `/undo`
کانٹیکسٹ (context) کمپریس کریں / استعمال چیک کریں	`/compress`، `/usage`، `/insights [--days N]`	`/compress`، `/usage`، `/insights [days]`
مہارتیں (Skills) براؤز کریں	`/skills` یا `/<skill-name>`	`/<skill-name>`
موجودہ کام کو روکیں	`Ctrl+C` دبائیں یا نیا میسج بھیجیں	`/stop` یا نیا میسج بھیجیں
پلیٹ فارم کے لحاظ سے سٹیٹس	`/platforms`	`/status`، `/sethome`

</div>

مکمل کمانڈ لسٹ کے لیے، CLI گائیڈ اور میسجنگ گیٹ وے گائیڈ دیکھیں۔

دستاویزات (Documentation)

تمام دستاویزات hermes-agent.nousresearch.com/docs پر موجود ہیں:

سیکشن (Section)	تفصیل (What's Covered)
فوری آغاز (Quickstart)	انسٹالیشن → سیٹ اپ → 2 منٹ میں پہلی بات چیت شروع کریں
CLI کا استعمال	کمانڈز، کی بائنڈنگز (keybindings)، پرسنلٹیز (personalities)، سیشنز
کنفیگریشن (Configuration)	کنفگ فائل، پرووائیڈرز، ماڈلز، اور تمام آپشنز
میسجنگ گیٹ وے	ٹیلی گرام، ڈسکارڈ، سلیک، واٹس ایپ، سگنل، ہوم اسسٹنٹ
سیکیورٹی (Security)	کمانڈ کی منظوری، DM پیئرنگ (pairing)، کنٹینر آئسولیشن
ٹولز اور ٹول سیٹس	40 سے زائد ٹولز، ٹول سیٹ سسٹم، ٹرمینل بیک اینڈز
مہارتوں کا سسٹم (Skills System)	پروسیجرل (Procedural) میموری، سکلز ہب، نئی مہارتیں بنانا
میموری (Memory)	مستقل میموری، یوزر پروفائلز، بہترین طریقہ کار
MCP انضمام (Integration)	صلاحیتوں کو بڑھانے کے لیے کسی بھی MCP سرور کو جوڑیں
کرون (Cron) شیڈیولنگ	پلیٹ فارم ڈیلیوری کے ساتھ شیڈول کیے گئے کام
کانٹیکسٹ (Context) فائلز	پروجیکٹ کا سیاق و سباق (context) جو ہر بات چیت پر اثر انداز ہوتا ہے
آرکیٹیکچر (Architecture)	پروجیکٹ کا ڈھانچہ، ایجنٹ لوپ، اہم کلاسز
تعاون (Contributing)	ڈیویلپمنٹ سیٹ اپ، PR کا طریقہ کار، کوڈنگ کا انداز
CLI حوالہ جات (Reference)	تمام کمانڈز اور فلیگز (flags)
انوائرمنٹ ویری ایبلز	مکمل انوائرمنٹ ویری ایبل حوالہ جات

</div>

OpenClaw سے منتقلی

اگر آپ OpenClaw سے منتقل ہو رہے ہیں، تو ہرمیس آپ کی سیٹنگز، یادیں (memories)، مہارتیں (skills)، اور API کیز کو خود بخود امپورٹ کر سکتا ہے۔

پہلی بار سیٹ اپ کے دوران: سیٹ اپ وزرڈ (hermes setup) خود بخود ~/.openclaw کو پہچان لیتا ہے اور کنفیگریشن شروع ہونے سے پہلے مائیگریٹ (migrate) کرنے کا آپشن دیتا ہے۔

انسٹالیشن کے بعد کسی بھی وقت:

bash

hermes claw migrate              # انٹرایکٹو مائیگریشن (مکمل پری سیٹ)
hermes claw migrate --dry-run    # جائزہ لیں کہ کیا کیا مائیگریٹ ہوگا
hermes claw migrate --preset user-data   # حساس معلومات (secrets) کے بغیر مائیگریٹ کریں
hermes claw migrate --overwrite  # موجودہ متصادم فائلوں کو اوور رائٹ کریں

</div>

جو چیزیں امپورٹ ہوتی ہیں:

SOUL.md — پرسونا (persona) فائل
میموریز (Memories) — MEMORY.md اور USER.md کی اندراجات
مہارتیں (Skills) — صارف کی بنائی گئی مہارتیں → ~/.hermes/skills/openclaw-imports/
کمانڈ الاؤ لسٹ (allowlist) — منظوری کے پیٹرنز (approval patterns)
میسجنگ سیٹنگز — پلیٹ فارم کنفیگریشنز، اجازت یافتہ صارفین، ورکنگ ڈائریکٹری
API کیز — الاؤ لسٹ شدہ حساس معلومات (ٹیلی گرام، OpenRouter، OpenAI، Anthropic، ElevenLabs)
TTS اثاثے — ورک اسپیس کی آڈیو فائلیں
ورک اسپیس کی ہدایات — AGENTS.md (--workspace-target کے ساتھ)

تمام آپشنز دیکھنے کے لیے hermes claw migrate --help استعمال کریں، یا انٹرایکٹو ایجنٹ کی مدد سے مائیگریٹ کرنے کے لیے openclaw-migration سکل کا استعمال کریں (جس میں ڈرائی رن (dry-run) پریویوز شامل ہیں)۔

تعاون کریں (Contributing)

ہم آپ کے تعاون کا خیرمقدم کرتے ہیں! ڈیویلپمنٹ سیٹ اپ، کوڈ کے انداز اور PR کے طریقہ کار کے لیے براہ کرم ہماری Contributing گائیڈ دیکھیں۔

معاونین (contributors) کے لیے فوری آغاز — کلون (clone) کریں اور setup-hermes.sh چلائیں:

bash

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
./setup-hermes.sh     # uv کو انسٹال کرتا ہے، venv بناتا ہے، .[all] کو انسٹال کرتا ہے، اور ~/.local/bin/hermes کا سیم لنک (symlink) بناتا ہے
./hermes              # خود بخود venv کی شناخت کرتا ہے، پہلے `source` کرنے کی ضرورت نہیں

</div>

مینوئل طریقہ (اوپر والے طریقے کے مساوی):

bash

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv .venv --python 3.11
source .venv/bin/activate
uv pip install -e ".[all,dev]"
scripts/run_tests.sh

</div>

کمیونٹی (Community)

💬 ڈسکارڈ (Discord)
📚 سکلز ہب (Skills Hub)
🐛 مسائل (Issues)
🔌 computer-use-linux — ہرمیس اور دیگر MCP ہوسٹس کے لیے لینکس (Linux) ڈیسک ٹاپ کنٹرول MCP سرور، جس میں AT-SPI ایکسیسیبلٹی ٹریز، Wayland/X11 ان پٹ، سکرین شاٹس، اور کمپوزیٹر ونڈو ٹارگیٹنگ شامل ہے۔
🔌 HermesClaw — کمیونٹی وی چیٹ (WeChat) برج: ہرمیس ایجنٹ اور OpenClaw کو ایک ہی وی چیٹ اکاؤنٹ پر چلائیں۔

لائسنس (License)

MIT — تفصیلات کے لیے LICENSE دیکھیں۔

نوس ریسرچ (Nous Research) کی جانب سے تیار کردہ۔

</div>