Ars Umbris کے ساتھ آغاز: ٹائپڈ، ایجنٹ نیٹو IDE انسٹال کریں اور دریافت کریں

Ars Umbris کیا ہے؟

Ars Umbris ٹائپ شدہ علم کے لیے ایک لچک دار، ایجنٹ-نیٹو IDE ہے۔ یہ علم، اقسام، مہارتوں، ٹولز اور UI اجزا کو ایسے قابلِ ترکیب ریپوزٹریز میں یکجا کرتا ہے جو ایک دوسرے پر انحصار کر سکتی ہیں۔

یہ منصوبہ ان ریپوزٹریز کو ایک واحد ٹائپ شدہ گراف کے طور پر پڑھتا ہے۔ یہ فیلڈز اور حوالہ جات کی جانچ کرتا ہے، پھر ایسی تشخیصی معلومات فراہم کرتا ہے جن پر ایجنٹس عمل کر سکتے ہیں۔ انسان اور ایجنٹس یکساں بنیادی اجزا اور SDKs استعمال کرکے ٹولز بنا سکتے ہیں، ویوز شامل کر سکتے ہیں اور ایپلیکیشن میں ترمیم کر سکتے ہیں۔

Ars Umbris فی الحال ابتدائی الفا مرحلے میں ہے، اس لیے خرابیوں اور ایسی تبدیلیوں کی توقع رکھیں جو سابقہ مطابقت توڑ سکتی ہیں۔ فی الحال یہ صرف macOS کو سپورٹ کرتا ہے۔

آرکیٹیکچر باہم کیسے جڑتا ہے

Ars Umbris کو تین بنیادی تہوں میں منظم کیا گیا ہے۔ ان تہوں کو سمجھنے سے آپ کو یہ فیصلہ کرنے میں مدد ملتی ہے کہ سسٹم کو ترتیب دیتے یا وسیع کرتے وقت کہاں دیکھنا ہے۔

1. au-engine

au-engine ایک ٹائپ شدہ فائل سبسٹریٹ پر بنایا گیا کراس-ریپوزٹری گراف انجن ہے۔ یہ مختلف ریپوزٹریز کی فائلوں کو انڈیکس کرتا ہے اور انہیں ایک ٹائپ شدہ، قابلِ استفسار، لائیو گراف میں تبدیل کرتا ہے۔

یہ انجن Markdown اور YAML فائلوں کے لیے ایک حسبِ ضرورت ٹائپنگ زبان بھی نافذ کرتا ہے۔ مزید تفصیل کے لیے au-engine.md پڑھیں۔

2. au-host

au-host Electron کی میزبان ایپلیکیشن ہے۔ یہ گراف پر ٹائپ شدہ پروجیکشنز، یعنی ویوز، نصب کرتی ہے اور ٹائپ شدہ ڈیٹا پر ترتیبِ تشکیل سے چلنے والی کمپوزیشنز کو سپورٹ کرتی ہے۔

یہ کمپوزیشنز قابلِ ترمیم ہیں اور انسانوں اور ایجنٹس دونوں کے ذریعے چلائی جا سکتی ہیں۔ میزبان کی دستاویزات کے لیے au-host.md دیکھیں۔

3. au-mcp

au-mcp قابلِ توسیع ایجنٹ تہہ فراہم کرتا ہے۔ یہ MCP کے ذریعے ٹائپ شدہ ٹولز اور مہارتیں ظاہر کرتا ہے اور اڈاپٹرز کے ذریعے آپ کے منتخب کردہ ایجنٹ ہارنس سے رابطہ کرتا ہے۔

MCP تہہ کے بارے میں مزید جاننے کے لیے au-mcp.md پڑھیں۔

انسٹالیشن کی تیاری

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

• ~/arsumbris/ میں متعدد Ars Umbris ریپوزٹریز رکھی جاتی ہیں۔
• ~/.arsumbris/ میں Ars Umbris کی کنفیگریشن فائلیں رکھی جاتی ہیں۔

چونکہ یہ منصوبہ صرف macOS کے لیے ہے اور اب بھی فعال ترقی کے مرحلے میں ہے، اس لیے سسٹم میں تبدیلیاں کرنے سے پہلے ضروریات کا جائزہ لیں۔ مطلوبہ سافٹ ویئر اور سیٹ اپ کی ترتیب کے لیے ریپوزٹری کی موجودہ انسٹالیشن ہدایات ہی مستند ماخذ ہیں۔

انٹری پوائنٹ ریپوزٹری انسٹال کریں

README تجویز کرتا ہے کہ آپ اپنے ایجنٹ سے درج ذیل ہدایات کے ذریعے انسٹالیشن کروائیں:

Please help me install Ars Umbris.

1) Create two folders if they do not already exist:
   - ~/arsumbris/ will hold multiple repositories.
   - ~/.arsumbris/ will hold configurations.

2) Clone the entry-point repository:
   git clone https://github.com/arsumbris/arsumbris.git ~/arsumbris/arsumbris
   If that destination already exists, inspect it before proceeding; do not overwrite it.

3) Read ~/arsumbris/arsumbris/INSTALL.md and follow its current setup process.
   Check prerequisites and explain any changes needed on my machine before making them.

اہم حفاظتی مرحلہ یہ ہے کہ کلون کرنے سے پہلے موجودہ ~/arsumbris/arsumbris ڈائریکٹری کا جائزہ لیا جائے۔ موجودہ چیک آؤٹ کو اوور رائٹ نہ کریں۔ ریپوزٹری دستیاب ہونے کے بعد INSTALL.md کھولیں اور دستاویز کردہ ترتیب کے مطابق اس کی موجودہ ہدایات پر عمل کریں۔

ریپوزٹری کے موجودہ سیٹ اپ کے عمل کی پیروی کریں

1. تصدیق کریں کہ آپ macOS استعمال کر رہے ہیں۔
2. اگر ~/arsumbris/ اور ~/.arsumbris/ موجود نہ ہوں تو انہیں بنائیں۔
3. چیک کریں کہ آیا ~/arsumbris/arsumbris پہلے سے موجود ہے۔
4. اگر یہ موجود نہ ہو تو git clone https://github.com/arsumbris/arsumbris.git ~/arsumbris/arsumbris کے ذریعے ریپوزٹری کلون کریں۔
5. اگر یہ پہلے سے موجود ہو تو اسے تبدیل کرنے کے بجائے اس کا جائزہ لیں۔
6. ~/arsumbris/arsumbris/INSTALL.md پڑھیں۔
7. اس فائل میں بیان کردہ ضروریات کو چیک اور انسٹال کریں، اور مشین میں مجوزہ تبدیلیاں لاگو کرنے سے پہلے ان کا جائزہ لیں۔
8. INSTALL.md میں دستاویز کردہ ترتیب کے مطابق باقی سیٹ اپ مراحل مکمل کریں۔

چونکہ Ars Umbris فعال ترقی کے مرحلے میں ہے، اس لیے تیسرے فریق کے ذرائع سے حاصل کردہ پرانی سیٹ اپ ہدایات پر انحصار نہ کریں۔ آپ جو ورژن انسٹال کر رہے ہیں، اس کے لیے چیک آؤٹ کی گئی ریپوزٹری کی انسٹالیشن گائیڈ استعمال کریں۔

بنیادی استعمال کے تصورات

Ars Umbris کو ٹائپ شدہ علم اور صلاحیتوں پر مشتمل ریپوزٹریز کے گرد ڈیزائن کیا گیا ہے۔ ایک ریپوزٹری میں علم، اقسام کی تعریفیں، مہارتیں، ٹولز اور UI اجزا شامل ہو سکتے ہیں۔ ریپوزٹریز دوسری ریپوزٹریز پر انحصار بھی کر سکتی ہیں، جس سے مختلف منصوبوں میں صلاحیتوں اور علم کا دوبارہ استعمال ممکن ہوتا ہے۔

اعلیٰ سطح پر، ایک عام ورک فلو یوں دکھائی دیتا ہے:

1. متعلقہ ریپوزٹریز کو ~/arsumbris/ کے اندر رکھیں یا کلون کریں۔
2. au-engine کو ان ریپوزٹریز میں موجود فائل سبسٹریٹ کو انڈیکس کرنے دیں۔
3. حاصل ہونے والے ٹائپ شدہ گراف کو مربوط ڈیٹا، فیلڈز اور حوالہ جات کے ساتھ کام کرنے کے لیے استعمال کریں۔
4. گراف پر پروجیکشنز اور ویوز نصب کرنے کے لیے au-host استعمال کریں۔
5. au-mcp اور MCP اڈاپٹرز کے ذریعے ایجنٹ ہارنس منسلک کریں۔
6. تشخیصی معلومات کا جائزہ لینے، ٹولز بنانے، ویوز شامل کرنے اور ایپلیکیشن میں ترمیم کرنے کے لیے ایجنٹس یا انسانی صارفین کو استعمال کریں۔

README کسی ایک نمونہ منصوبے یا کمانڈ لائن ورک فلو کا تعین نہیں کرتا۔ آپ کے مخصوص کمانڈز اور دستیاب پروجیکشنز کا انحصار INSTALL.md میں بیان کردہ سیٹ اپ اور ان ریپوزٹریز پر ہے جنہیں آپ منسلک کرتے ہیں۔

MCP کے ذریعے ایجنٹس کے ساتھ کام کرنا

Ars Umbris کو Model Context Protocol کے ذریعے ایجنٹ ہارنس سے منسلک ہونے کے لیے بنایا گیا ہے۔ au-mcp تہہ ٹائپ شدہ ٹولز اور مہارتیں فراہم کرتی ہے، جبکہ اڈاپٹرز ان صلاحیتوں کو آپ کے منتخب کردہ ہارنس سے منسلک کرتے ہیں۔

اس کے ذریعے ایجنٹ وہی بنیادی اجزا اور SDKs استعمال کر سکتا ہے جو ایپلیکیشن بنانے کے لیے استعمال ہوتے ہیں۔ عملی طور پر، ایجنٹ ٹولز بنانے، ویوز شامل کرنے اور ایپ میں ترمیم کرنے میں حصہ لے سکتا ہے، بشرطیکہ یہ صلاحیتیں اور کنفیگریشن آپ کی انسٹالیشن میں دستیاب ہوں۔

اعلیٰ درجے کی تجاویز اور حفاظتی امور

ریپوزٹریز کو قابلِ ترکیب رکھیں

علم اور صلاحیتوں کو ایسی ریپوزٹریز میں منظم کریں جنہیں دوبارہ استعمال اور آپس میں منسلک کیا جا سکے۔ ریپوزٹریز کے درمیان انحصار پروجیکٹ ماڈل کا مرکزی حصہ ہیں، اس لیے ریپوزٹریز کو الگ الگ فولڈرز کے بجائے ایک ہی ٹائپ شدہ گراف کے حصوں کے طور پر سمجھیں۔

تشخیصی نتائج کو فیڈبیک کے طور پر استعمال کریں

انجن ٹائپ شدہ گراف میں موجود فیلڈز اور حوالہ جات کی جانچ کرتا ہے۔ ٹائپ شدہ Markdown، YAML یا متعلقہ ریپوزٹری مواد میں ترمیم کرتے وقت، خاص طور پر جب کوئی ایجنٹ تبدیلیاں کر رہا ہو، اس کی تشخیصی معلومات کو فیڈبیک کے طور پر استعمال کریں۔

لیئر کی دستاویزات پڑھیں

جب آپ کو رویے کو سمجھنے کی ضرورت ہو تو متعلقہ لیئر کی دستاویزات دیکھیں: انجن، ہوسٹ، یا MCP ایجنٹ لیئر۔

تبدیلیاں لاگو کرنے سے پہلے ان کا جائزہ لیں

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

موجودہ سیکیورٹی ماڈل کو مدِنظر رکھیں

Ars Umbris آپ کی مشین پر کوڈ چلاتا ہے اور فی الحال اس میں کوئی سینڈ باکسنگ نہیں ہے۔ پروجیکٹ استعمال کرنے سے پہلے SAFETY.md کا جائزہ لیں، خاص طور پر ایجنٹس کو منسلک کرتے وقت یا ایسی ریپوزٹریز کے ساتھ کام کرتے وقت جن پر آپ کا مکمل اختیار نہیں ہے۔

نتیجہ

Ars Umbris ایک تجرباتی IDE برائے ٹائپ شدہ علم ہے، جو ٹائپ شدہ کراس ریپوزٹری گراف، Electron پر مبنی ہوسٹ، اور MCP ایجنٹ لیئر کو یکجا کرتا ہے۔ آغاز کرنے کے لیے، دو کنفیگریشن ڈائریکٹریز تیار کریں، موجودہ فائلوں کو اوور رائٹ کیے بغیر انٹری پوائنٹ ریپوزٹری کلون کریں، اور اس کی موجودہ INSTALL.md کی ہدایات پر عمل کریں۔ انسٹال ہونے کے بعد، دریافت کریں کہ ریپوزٹریز، پروجیکشنز، ٹولز، اسکلز اور ایجنٹس کس طرح مل کر کام کرتے ہیں، جبکہ پروجیکٹ کی الفا حیثیت اور غیر سینڈ باکس شدہ ایگزیکیوشن ماڈل کو ذہن میں رکھیں۔