مرکزی مواد پر جائیں
اے آئی ٹیوٹوریلز

Hermes Agent کے ساتھ سرکاری پلگ اِنز انسٹال اور استعمال کریں

Hermes Agent انسٹال کرنے، اس کے جائزہ شدہ پلگ اِن کیٹلاگ کو دریافت کرنے، سرکاری پلگ اِنز شامل اور اپ ڈیٹ کرنے، پرانی تنصیبات منتقل کرنے اور پلگ اِنز کو مقامی طور پر ٹیسٹ کرنے کا طریقہ جانیں۔ یہ رہنما دستیاب فرسٹ پارٹی انضمامات کا تعارف بھی فراہم کرتا ہے اور بتاتا ہے کہ کیٹلاگ پنز کنٹرول شدہ ریلیزز کیسے فراہم کرتے ہیں۔

تقریباً 23 منٹ کا مطالعہ
Hermes Agent کے ساتھ سرکاری پلگ اِنز انسٹال اور استعمال کریں
Hermes کے آفیشل پلگ اِنز

Hermes کے آفیشل پلگ اِنز کیا فراہم کرتے ہیں

Hermes کے آفیشل پلگ اِنز Hermes Agent کے لیے Nous Research کی جانب سے برقرار رکھی جانے والی فرسٹ پارٹی پلگ اِنز کی کلیکشن ہے۔ ریپوزٹری کی ہر ڈائریکٹری میں ایک خودمختار انٹیگریشن موجود ہے جسے Hermes پلگ اِن کیٹلاگ کے ذریعے انسٹال کیا جا سکتا ہے۔

Hermes Agent ایک خود کو بہتر بنانے والا AI ایجنٹ ہے جو سیشنز کے درمیان مفید معلومات محفوظ رکھ سکتا ہے، تجربے سے مہارتیں پیدا کر سکتا ہے، اور ٹرمینل، Hermes Desktop، Telegram، Discord، Slack، WhatsApp اور Signal جیسے انٹرفیسز کے ذریعے چل سکتا ہے۔ یہ متعدد ماڈل ذرائع کو سپورٹ کرتا ہے، جن میں Nous Portal، OpenRouter، Anthropic، OpenAI اور کسٹم اینڈ پوائنٹس شامل ہیں۔

یہ پروجیکٹ Hermes کے عالمی حصوں، بشمول ایجنٹ لوپ، میموری، مہارتیں، گیٹ وے، ماڈل روٹنگ اور ٹول رن ٹائم، کو کور میں رکھتا ہے۔ پروڈکٹ سے متعلق اور وینڈر سے متعلق صلاحیتیں الگ پلگ اِنز میں رہتی ہیں۔

Hermes پلگ اِنز کیوں استعمال کرتا ہے

  • چھوٹی انسٹالیشنز: آپ صرف مطلوبہ انٹیگریشنز انسٹال کرتے ہیں۔
  • آزادانہ اصلاحات: کسی پلگ اِن کو Hermes کور کی نئی ریلیز کا انتظار کیے بغیر جائزہ شدہ اپ ڈیٹ مل سکتی ہے۔
  • واضح ملکیت: Nous آفیشل پلگ اِنز برقرار رکھتا ہے، جبکہ وینڈرز اور آزاد مصنفین کمیونٹی پلگ اِنز برقرار رکھتے ہیں۔
  • جائزہ شدہ ورژنز: کیٹلاگ اندراجات جائزہ شدہ کمٹس پر پن کیے جاتے ہیں، اس لیے انسٹالیشن اور اپ ڈیٹس معلوم ریویژنز استعمال کرتے ہیں۔
  • مؤثر ڈاؤن لوڈز: Hermes blobless sparse clone کے ذریعے صرف منتخب پلگ اِن ڈائریکٹری حاصل کرتا ہے۔

ضروریات اور Hermes کی انسٹالیشن

ان پلگ اِنز کو شامل کرنے سے پہلے آپ کے پاس Hermes Agent کی فعال انسٹالیشن ہونی چاہیے۔ معاونت یافتہ سسٹم پر Hermes README میں دیا گیا انسٹالیشن اسکرپٹ چلائیں:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

انسٹالیشن کے بعد تصدیق کریں کہ کمانڈ لائن انٹرفیس دستیاب ہے:

hermes --help

انفرادی پلگ اِنز کی اضافی ضروریات ہو سکتی ہیں۔ مثال کے طور پر Spotify کے لیے لاگ اِن کے لیے آپ کی اپنی Spotify ڈویلپر ایپلیکیشن درکار ہے، Blender کے لیے Blender 5.1 یا اس کے بعد کا ورژن اور اس کا MCP ایڈ آن درکار ہے، جبکہ Snyk کے لیے Node.js، npm اور Snyk اکاؤنٹ ضروری ہے۔ کسی پلگ اِن کو انسٹال کرنے سے پہلے اس کی کیٹلاگ معلومات کا جائزہ لیں۔

پلگ اِن کیٹلاگ دیکھیں

Hermes پلگ اِن کیٹلاگ میں جائزہ شدہ آفیشل اور کمیونٹی انٹیگریشنز شامل ہیں۔ دستیاب اندراجات دیکھنے کے لیے سرچ کمانڈ استعمال کریں:

hermes plugins search

انسٹالیشن سے پہلے کسی مخصوص پلگ اِن کی تفصیلات دیکھیں:

hermes plugins info spotify

معلوماتی اندراج میں پلگ اِن کا کام، اس کی ضروریات اور وہ جائزہ شدہ کمٹ درج ہوتی ہے جس پر اسے پن کیا گیا ہے۔ Hermes Desktop کے صارفین اسی کیٹلاگ تک Capabilities → Plugins میں رسائی حاصل کر سکتے ہیں۔

پلگ اِن انسٹال اور اپ ڈیٹ کریں

  1. مطلوبہ انٹیگریشن تلاش کریں:

    hermes plugins search

  2. اس کی ضروریات اور میٹا ڈیٹا پڑھیں:

    hermes plugins info spotify

  3. جائزہ شدہ ورژن انسٹال کریں:

    hermes plugins install spotify

  4. جب نیا جائزہ شدہ پن دستیاب ہو جائے تو پلگ اِن اپ ڈیٹ کریں:

    hermes plugins update spotify

اپ ڈیٹ کیٹلاگ میں موجود اگلے جائزہ شدہ کمٹ کی پیروی کرتی ہے۔ یہ من مانے ریپوزٹری ریویژن کو خودکار طور پر انسٹال نہیں کرتی۔

آفیشل پلگ اِن منتخب کریں

Home Assistant

Home Assistant پلگ اِن ایک گیٹ وے پلیٹ فارم اور چار ٹولز شامل کرتا ہے جو اینٹٹیز کی فہرست بنانے، اسٹیٹس پڑھنے، سروسز کی فہرست بنانے اور سروسز کال کرنے کے لیے ہیں۔ Hermes ایونٹ بس کی نگرانی کر سکتا ہے، منتخب اسٹیٹ تبدیلیوں پر ردِعمل دے سکتا ہے، REST API کے ذریعے آلات کو کنٹرول کر سکتا ہے اور Home Assistant نوٹیفکیشنز کے ذریعے جواب دے سکتا ہے۔

hermes plugins install homeassistant

اس کے ٹولز ha_list_entities، ha_get_state، ha_list_services اور ha_call_service ہیں۔ Cron jobs، deliver=homeassistant کے ذریعے Home Assistant کو ہدف بنا سکتی ہیں۔

Spotify

Spotify پلگ اِن پلے بیک، Spotify Connect ڈیوائسز، قطار، سرچ، پلے لسٹس، البمز اور صارف کی لائبریری کے لیے ٹولز فراہم کرتا ہے۔

hermes plugins install spotify
hermes spotify login

لاگ اِن کمانڈ آپ کی اپنی Spotify ڈویلپر ایپلیکیشن استعمال کرتے ہوئے loopback PKCE لاگ اِن مکمل کرتی ہے۔ پلے بیک کنٹرول کے لیے Spotify Premium ضروری ہے۔

Claude Subscription DirectSDK

یہ تجرباتی ماڈل پرووائیڈر Claude Pro یا Max سبسکرپشن کے ذریعے آفیشل Claude Code CLI استعمال کرتے ہوئے Hermes turns چلاتا ہے۔ Hermes اپنا ایجنٹ لوپ، ٹولز، منظوری کا انتظام اور کمپیکشن برقرار رکھتا ہے، جبکہ پلگ اِن تصدیق شدہ claude بائنری کو request-scoped ماڈل کلائنٹ کے طور پر استعمال کرتا ہے۔

hermes plugins install claude-subscription-directsdk

انسٹالیشن کے بعد hermes model کھولیں اور Claude Subscription DirectSDK (Experimental) منتخب کریں۔ اگر Claude Code دستیاب نہ ہو تو پلگ اِن چلنے سے انکار کر دیتا ہے اور انسٹالیشن کی رہنمائی فراہم کرتا ہے۔

ٹیلیگرام بزنس موڈ

ٹیلیگرام بزنس موڈ، Hermes کو ٹیلیگرام بزنس اکاؤنٹ کے لیے منظوری کے بعد مشاہدہ کرنے والا معاون بنا دیتا ہے۔ یہ صارفین کے جوابات کا مسودہ تیار کر سکتا ہے، لیکن بھیجنے سے پہلے ہر جواب کے لیے مالک کی منظوری ضروری ہے۔

hermes plugins install hermes-telegram-business

میموری وکی

میموری وکی ایک ڈیش بورڈ اور Hermes Desktop ٹیب شامل کرتا ہے، جو مقامی سیشن ہسٹری کو موضوعاتی صفحات اور روزانہ کے لاگز میں منظم کرتا ہے۔ یہ MEMORY.md اور USER.md کے لیے صرف پڑھنے کے قابل آڈٹ پینل بھی فراہم کرتا ہے۔ پلگ اِن مقامی ہسٹری پڑھتا ہے اور اس میں کچھ نہیں لکھتا۔

hermes plugins install hermes-memory-wiki

Blender

Blender پلگ اِن، آفیشل Blender Lab MCP سرور کو Blender ورک فلو اسکل کے ساتھ جوڑتا ہے۔ اس کے لیے MCP ایڈ آن کے ساتھ Blender 5.1 یا اس کے بعد کا ورژن، نیز Git اور uv درکار ہیں۔ یہ Windows، macOS، اور Linux کو سپورٹ کرتا ہے۔

hermes plugins install blender

Blender کے ٹولز Blender کے اندر Python چلاتے ہیں۔ صرف قابلِ اعتماد ورک فلو استعمال کریں اور ایسے آپریشنز کا جائزہ لیں جو آپ کے سین میں تبدیلی کر سکتے ہیں۔

Snyk

Snyk پلگ اِن، Snyk کے فرسٹ پارٹی MCP سرور کو استعمال کرتا ہے اور اس میں snyk-security-scan ورک فلو اسکل شامل ہے۔ یہ سورس کوڈ، انحصارات، کنٹینر امیجز، infrastructure-as-code کنفیگریشنز، اور سافٹ ویئر بلز آف میٹریلز اسکین کر سکتا ہے۔

hermes plugins install snyk

اس کے لیے Node.js، npm، اور Snyk اکاؤنٹ درکار ہے۔ توثیق براؤزر کے ذریعے snyk_auth استعمال کرتے ہوئے کی جاتی ہے۔

TouchDesigner

TouchDesigner پلگ اِن، 404.zero کے مفت twozero MCP سرور کے ذریعے ایک فعال TouchDesigner سیشن سے جڑتا ہے، جو TouchDesigner کے اندر چلتا ہے۔ اس میں ایک ورک فلو اسکل اور 20 سے زیادہ حوالہ جاتی فائلیں شامل ہیں، جن میں operators، GLSL، audio-reactive projects، اور instancing جیسے موضوعات شامل ہیں۔

hermes plugins install touchdesigner

TouchDesigner کے لیے macOS اور Windows کی معاونت درج ہے۔

Accent Picker

Accent Picker ایک Hermes Desktop پلگ اِن ہے جو اسٹیٹس بار میں OKLCH کلر وہیل شامل کرتا ہے۔ پکَر کو گھسیٹنے سے تھیم کا رنگ حقیقی وقت میں بدلتا ہے، جس سے تھیم کے مصنفین موقع پر ہی ایکسنٹ رنگوں کی جانچ کر سکتے ہیں۔ منتخب کردہ رنگ عارضی scratch state ہے اور محفوظ نہیں کیا جاتا۔

hermes plugins install accent-picker

پرانے انسٹالیشن کو منتقل کریں

کئی آفیشل پلگ اِن پہلے Hermes core یا الگ repositories میں موجود تھے۔ مطلوبہ منتقلی اس بات پر منحصر ہے کہ آپ نے انہیں اصل میں کیسے انسٹال کیا تھا۔

  • Built-in Home Assistant یا Spotify: hermes update چلائیں۔ اپ ڈیٹ کے بعد پہلی بار شروع ہونے پر کیٹلاگ پلگ اِن انسٹال ہو سکتا ہے، جبکہ موجودہ کنفیگریشن، ماحول کے متغیرات، اور لاگ اِن برقرار رہتے ہیں۔
  • Catalog installation: hermes plugins update <name> چلائیں۔ کیٹلاگ اب آفیشل پلگ اِنز repository کی طرف اشارہ کرتا ہے اور منتقلی کے دوران آپ کی فائلیں برقرار رکھتا ہے۔
  • URL-based installation: hermes plugins install <name> --force کے ساتھ کیٹلاگ سے ایک بار دوبارہ انسٹال کریں۔ یہ ضروری ہے کیونکہ پرانی standalone repositories archive ہو چکی ہیں اور انہیں مزید fixes نہیں ملتے۔

ریپوزٹری کی ساخت سمجھیں

ہر top-level پلگ اِن directory ایک مکمل package ہوتی ہے۔ Python پلگ اِنز میں عموماً manifest، registration code، dependencies، اور tests شامل ہوتے ہیں۔ Portable MCP-based پلگ اِنز میں plugin.json، mcp.json، اور skills directory استعمال ہو سکتی ہے، جبکہ Desktop پلگ اِنز میں desktop directory کے اندر JavaScript شامل ہو سکتی ہے۔

hermes-official-plugins/
├── assets/
├── homeassistant/
│   ├── plugin.yaml
│   ├── __init__.py
│   ├── pyproject.toml
│   └── tests/
├── blender/
├── accent-picker/
└── ...

کیٹلاگ کسی پلگ اِن کی شناخت repository، subdirectory، اور pinned commit سے کرتا ہے۔ نتیجتاً، Spotify انسٹال کرنے سے Home Assistant پلگ اِن ڈاؤن لوڈ نہیں ہوتا۔

پلگ اِن کو مقامی طور پر ٹیسٹ کریں

ترقی کے لیے Hermes Agent اور آفیشل پلگ اِن repository کو ایک دوسرے کے ساتھ کلون کریں:

git clone https://github.com/NousResearch/hermes-agent
git clone https://github.com/NousResearch/hermes-official-plugins
cd hermes-official-plugins/spotify
HERMES_AGENT_REPO=../../hermes-agent PYTHONPATH=../../hermes-agent python -m pytest -q

ہر push اور pull request کے لیے آفیشل پلگ اِنز کو Linux، macOS، اور Windows پر موجودہ Hermes core کے خلاف ٹیسٹ کیا جاتا ہے۔ core کی ایسی تبدیلیوں کا پتا لگانے کے لیے nightly testing بھی استعمال کی جاتی ہے جو پلگ اِنز کو توڑ سکتی ہیں۔

مقامی checkout کو فعال Hermes ماحول میں انسٹال کرنے کے لیے directory path دیں اور replacement پر مجبور کریں:

hermes plugins install ./spotify --force

اعلیٰ درجے کی تجاویز

  • انسٹال کرنے سے پہلے جائزہ لیں: انحصارات اور جائزہ لیے گئے کمٹ کو چیک کرنے کے لیے hermes plugins info <name> استعمال کریں۔
  • کیٹلاگ کے ناموں کو ترجیح دیں: کیٹلاگ کے ذریعے انسٹالیشنز، براہِ راست URL کے ذریعے انسٹالیشنز کے مقابلے میں، مستقبل میں جائزہ لیے گئے پنز کے ساتھ زیادہ آسانی سے مطابقت رکھتی ہیں۔
  • فورس کا احتیاط سے استعمال کریں: --force آپشن منتقلی اور مقامی ٹیسٹنگ کے لیے مفید ہے، لیکن تصدیق کریں کہ آپ مطلوبہ انسٹالیشن ہی کو تبدیل کر رہے ہیں۔
  • منظوری کی حدود کا احترام کریں: Telegram Business Mode جیسے پلگ اِنز جواب بھیجنے سے پہلے دانستہ طور پر منظوری کے متقاضی ہوتے ہیں۔
  • طاقتور انضمامات کا جائزہ لیں: Blender جیسے ایپلی کیشنز میں کوڈ چلانے والے ٹولز صرف قابلِ اعتماد ورک فلو کے ساتھ استعمال کیے جانے چاہییں۔
  • مسائل کی اطلاع درست ریپوزٹری میں دیں: پلگ اِن سے متعلق مسائل سرکاری پلگ اِنز ریپوزٹری میں کھولیں اور عنوان میں پلگ اِن کا نام شامل کریں، مثلاً [spotify] ...۔ بنیادی مسائل کی اطلاع Hermes Agent کے مسائل کے ٹریکر میں دیں۔

پلگ اِنز جاری کرنا اور بنانا

مینٹینرز کے لیے، ریپوزٹری کی main برانچ میں پلگ اِن کی تبدیلی ضم کرنے سے کیٹلاگ صارفین خود بخود اپ ڈیٹ نہیں ہوتے۔ ریلیز اس وقت مکمل ہوتی ہے جب Hermes Agent کے خلاف پل ریکویسٹ کھولی جائے اور plugin-catalog/<name>.yaml میں پلگ اِن کی sha: قدر تبدیل کی جائے۔ کیٹلاگ پن ریلیز ورژن کے طور پر کام کرتا ہے۔

اپنا انضمام بنانے کے لیے Hermes پلگ اِن گائیڈ اور مثالی پلگ اِنز سے آغاز کریں۔ معیاری پلگ اِنز سادہ Python پیکیجز ہوتے ہیں جن میں plugin.yaml مینی فیسٹ شامل ہوتا ہے۔ مکمل شدہ پلگ اِنز کو جائزے کے لیے Hermes کیٹلاگ میں جمع کرایا جا سکتا ہے۔

نتیجہ

Hermes Official Plugins، ہر انضمام کو بنیادی حصے میں شامل کیے بغیر Hermes Agent کو توسیع دینے کا ایک کنٹرول شدہ طریقہ فراہم کرتا ہے۔ کیٹلاگ تلاش کریں، پلگ اِن کی ضروریات کا جائزہ لیں، اس کے جائزہ لیے گئے پن کو انسٹال کریں، اور بعد کے جائزہ لیے گئے نظرثانی شدہ ورژنز پر جانے کے لیے اپ ڈیٹ کمانڈ استعمال کریں۔ ڈویلپرز ریپوزٹری کلون کر کے، پلگ اِن سے متعلق ٹیسٹ چلا کر، اور حقیقی دنیا کی ٹیسٹنگ کے لیے مقامی ڈائریکٹریز انسٹال کر کے بھی کام کر سکتے ہیں۔