awesome-jev-tools کیا کرتا ہے
awesome-jev-tools عوامی منصوبوں اور ڈویلپر طریقۂ کار کی ایک مرتب کردہ ڈائریکٹری ہے جو Jev، یعنی TypeSafe AI کے typed decisions کے لیے System One ماڈل، پر مبنی ہے۔ یہ ایسی مثالیں جمع کرتی ہے جو بصورتِ دیگر لانچ تھریڈز، گیٹ وے فہرستوں، سوشل میڈیا اور انفرادی ریپوزٹریز میں بکھری رہتیں۔
Jev چیٹ ماڈل نہیں ہے۔ گفتگو پر مبنی متن تیار کرنے کے بجائے، یہ غیر ساختہ حالت کو ایک typed سوال کے مقابل جانچتا ہے اور ایک typed فیصلہ واپس کرتا ہے، جیسے انتخاب، اسکور یا بولین قدر، جس کے ساتھ اعتماد کی درجہ بندی بھی ہوتی ہے۔ اس بنا پر یہ سافٹ ویئر کے اندر محدود فیصلہ جاتی مقامات کے لیے موزوں ہے، جن میں روٹنگ، درجہ بندی، اسکورنگ، تصدیق اور ایجنٹ گارڈ ریلز شامل ہیں۔
یہ فہرست دو عملی سوالات کے جواب دینے کے لیے بنائی گئی ہے:
- حقیقی یا دعویٰ کردہ پروڈکشن ورک فلو میں Jev فیصلے کہاں کر رہا ہے؟
- کون سے فیصلہ جاتی ڈھانچے دوسرے منصوبوں اور صنعتوں میں منتقل کیے جا سکتے ہیں؟
شمولیت توثیق یا حمایت نہیں ہے۔ منتظمین اس بات کی ضمانت نہیں دیتے کہ کوئی اندراج کمپائل ہوگا، اس کے ٹیسٹ کامیاب ہوں گے، اس کے شائع شدہ نتائج دوبارہ حاصل کیے جا سکیں گے، وہ محفوظ ہوگا، یا اس کا لائسنس آپ کے استعمال کے لیے موزوں ہوگا۔
ریپوزٹری کی اہم خصوصیات
زمرہ جاتی منصوبہ اشاریہ
ہر منظور شدہ اندراج بالکل ایک زمرے سے تعلق رکھتا ہے، جس کا انتخاب اس کے براہِ راست اطلاق کے شعبے کی بنیاد پر کیا جاتا ہے۔ README موجودہ زمرہ جاتی فائلوں کو یکجا کرتی ہے، جس سے آپ ہر ذیلی صفحہ کھولے بغیر حالیہ منظور شدہ اندراجات دیکھ سکتے ہیں۔
اہم زمروں میں شامل ہیں:
- درجہ بندی اور روٹنگ: ماڈل کا انتخاب، ای میل کی نیت کی روٹنگ، براؤزر عناصر کی درجہ بندی، مہارت کا انتخاب اور ملتے جلتے کام۔
- تصدیق اور گارڈ ریلز: کوڈ ریویو گیٹس، کمانڈ کی منظوری، prompt injection سے تحفظ، pre-commit جانچ اور ایجنٹ کی نگرانی۔
- اسکورنگ اور درجہ بندی: مطابقت کی درجہ بندی، مواد کا جائزہ، کوڈ کے معیار کی اسکورنگ، حوالہ جاتی تصدیق اور retrieval reranking۔
- ایجنٹ کے فیصلے: محدود براؤزر اقدامات، coding-agent فیصلے، سیاق و سباق کی تراش خراش، تکمیل کی جانچ اور روبوٹکس کے فیصلے۔
- ڈیٹا لیبلنگ اور انتخاب: ڈیٹا کو منظم یا لیبل کرنے کے لیے استعمال ہونے والے typed decisions۔
- جائزہ اور بینچ مارکنگ: ایسے منصوبے جو Jev کے رویے کا جائزہ لیتے یا فیصلہ جاتی ورک فلو کا موازنہ کرتے ہیں۔
- کیلیبریشن اور تحقیق: فیصلہ جاتی معیار، اعتماد اور متعلقہ تحقیق پر مرکوز کام۔
- انفراسٹرکچر، SDKs اور انضمامات: گیٹ ویز، لائبریریاں، پلگ انز اور معاون ڈویلپر انفراسٹرکچر۔
- شعبہ جاتی زمرے: گیمز، سمیولیشنز، مالیات، ٹریڈنگ، تعمیل، قانونی ورک فلو اور مواد کی نگرانی۔
- متعلقہ طریقۂ کار اور مباحث: ایسا معاون مواد جو ریپوزٹری کے انتخابی قواعد پر پورا اترتا ہو۔
README ان زمروں کی بھی نشاندہی کرتی ہے جن میں ابھی اندراجات شامل کیے جا رہے ہیں۔ دستاویزی snapshot کے وقت Scientific Pipelines میں کوئی اندراج نہیں تھا۔
شمولیت کی سخت حدود
یہ فہرست ایسے عمومی classifiers، routers اور research agents کو خارج کرتی ہے جو Jev استعمال کیے بغیر محض اسی طرز سے مشابہت رکھتے ہوں۔ خالص نظریہ، ناقابلِ رسائی ذرائع، مبہم دعوے، کام کرنے والے artifact یا قابلِ تکرار نتیجے کے بغیر لانچ تبصرے، اور فہرست میں براہِ راست شامل کی گئی طویل تحریری وضاحتیں بھی خارج ہیں۔
یہ حدود ڈائریکٹری کو دریافت کے لیے مفید بناتی ہیں، لیکن تکنیکی جانچ پڑتال کی جگہ نہیں لیتیں۔
انسٹالیشن اور سیٹ اپ
منصوبہ دیکھنے کے لیے آپ کو کوئی پیکیج انسٹال کرنے کی ضرورت نہیں۔ سب سے آسان طریقہ یہ ہے کہ GitHub پر اس کی README کھولیں اور زمرے یا منصوبے کے لنکس پر جائیں۔
مقامی تلاش، ترمیم یا شراکت کے کام کے لیے GitHub کے clone مینو میں دکھایا گیا URL استعمال کرتے ہوئے ریپوزٹری clone کریں:
git clone <repository-url>
cd awesome-jev-toolsخود اس فہرست کے لیے کسی build step یا runtime setup کی وضاحت نہیں کی گئی۔ اس کا بنیادی مواد root README اور categories ڈائریکٹری کے اندر موجود Markdown فائلیں ہیں۔
مقامی طور پر دستیاب زمرہ جاتی فائلوں کی تصدیق کریں:
ls categoriesاس کے بعد آپ root README کو کسی editor میں کھول سکتے ہیں یا کسی مخصوص زمرہ جاتی فائل کا جائزہ لے سکتے ہیں۔ مثال کے طور پر:
less README.md
less categories/verification-guardrails.mdبنیادی استعمال: موزوں Jev منصوبہ تلاش کرنا
مرحلہ 1: وہ فیصلہ متعین کریں جس کی آپ کے سافٹ ویئر کو ضرورت ہے
وسیع پروڈکٹ کی وضاحت کے بجائے ایک محدود سوال سے آغاز کریں۔ طے کریں کہ آپ کی ایپلیکیشن کو کسی اختیار کا انتخاب کرنا ہے، اسکور دینا ہے، بولین طرز کے سوال کا جواب دینا ہے، امیدواروں کی درجہ بندی کرنی ہے یا کسی غیر محفوظ کارروائی کو روکنا ہے۔
مرکوز تقاضوں کی مثالیں:
- طے کریں کہ کسی درخواست کو کون سا ماڈل سنبھالے۔
- معلوم کریں کہ کسی tool call کی اجازت ہونی چاہیے، اسے مسترد کرنا چاہیے یا انسان کو بھیجنا چاہیے۔
- جواب کے ثبوت کے طور پر حاصل شدہ دستاویزات کی افادیت کا اسکور دیں۔
- فیصلہ کریں کہ آیا کسی ایجنٹ نے کام مکمل کر لیا ہے۔
- موصول ہونے والی ای میل کو invoice یا عمومی پیغام کے طور پر درجہ بند کریں۔
مرحلہ 2: قریب ترین زمرہ منتخب کریں
ہر ممکنہ ثانوی استعمال کے بجائے براہِ راست اطلاق کے شعبے کو استعمال کریں۔ ماڈل router کا تعلق Classification and Routing سے ہے، جبکہ command safety gate کا تعلق Verification and Guardrails سے ہے۔
مثال کے طور پر، اگر آپ کسی ایجنٹ کو خطرناک شیل کمانڈز سے محفوظ رکھنا چاہتے ہیں تو jev-guard، jev-axi، یا pi-jev جیسی اندراجات کا جائزہ لیں۔ اگر آپ کو بازیافت کی درجہ بندی درکار ہو تو jev-reranker یا Jev Search کا جائزہ لیں۔
مرحلہ 3: مقامی فہرست تلاش کریں
ڈومین، فیصلے کی قسم، یا انضمام کے نام سے تلاش کریں۔ درج ذیل کمانڈز کلون کی گئی ریپوزٹری کو براؤز کرنے کی مثالیں ہیں:
grep -Rni "confidence" README.md categories/
grep -Rni "Choice" README.md categories/
grep -Rni "pre-commit" README.md categories/
grep -Rni "browser" README.md categories/Choice کی تلاش ٹائپ شدہ انتخابی ورک فلو سامنے لا سکتی ہے۔ confidence کی تلاش ان منصوبوں کو تلاش کرنے میں مدد دے سکتی ہے جو واضح طور پر اسکیلیشن یا حد کے رویے کی وضاحت کرتے ہیں۔
مرحلہ 4: ماخذ منصوبے کی پیروی کریں
ہر فہرست کا اندراج صرف ایک مختصر حوالہ ہے۔ لنک شدہ منصوبہ کھولیں اور اس کی اپنی دستاویزات، سورس کوڈ، ٹیسٹس، مثالوں، ایشو ٹریکر، اور لائسنس کا مطالعہ کریں۔ awesome-jev-tools میں دی گئی مختصر وضاحت کو مکمل نفاذی رہنمائی نہ سمجھیں۔
اختیار کرنے سے پہلے کسی اندراج کی تصدیق کیسے کریں
- تصدیق کریں کہ یہ Jev API کو کال کرتا ہے۔ ایسی حقیقی درخواست تلاش کریں جس میں ٹائپ شدہ سوالات اور واپس آنے والے جواب کو پارس کرنے والا کوڈ شامل ہو۔ صرف عمدہ README انضمام کا ثبوت نہیں ہے۔
- قابلِ اجرا جانچ تلاش کریں۔ ایسے ٹیسٹ، عوامی ڈیمو، یا مثال کو ترجیح دیں جس کا متوقع آؤٹ پٹ موجود ہو۔ اس کے بغیر اس بات کے شواہد بہت کم ہوتے ہیں کہ نفاذ بیان کردہ طریقے سے کام کرتا ہے۔
- مقداری دعووں کا سراغ لگائیں۔ درستگی، تاخیر، لاگت، اور حجم کے اعداد و شمار کسی ماخذ یا قابلِ تکرار پیمائش کی طرف اشارہ کرنے چاہییں۔
- ریپوزٹری کے اصل مواد کا معائنہ کریں۔ معلوم کریں کہ کتنا حصہ قابلِ اجرا کوڈ ہے اور کتنا پرامپٹ دستاویزات، منصوبہ بندی کے مواد، یا ابتدائی ڈھانچے پر مشتمل ہے۔
- لائسنس کا جائزہ لیں۔ عوامی طور پر نظر آنے والے سورس کے باوجود لائسنس کی عدم موجودگی قانونی دوبارہ استعمال یا تقسیم میں رکاوٹ بن سکتی ہے۔
- دیکھ بھال کے اشاروں کا جائزہ لیں۔ کمٹ کی تاریخ، کھلے ایشوز، ٹیسٹس، ریلیز کی سرگرمی، اور اہم نفاذی تفصیلات کی دستاویز بندی کا معائنہ کریں۔
جب ایک ہی مصنف کی کئی ریپوزٹریز بیک وقت تقریباً یکساں فائلوں، مثلاً AGENTS.md، CLAUDE.md، STATE.md، اور CHANGELOG.md کے ساتھ ظاہر ہوں تو اضافی احتیاط کریں۔ ایسے منصوبے جائز ہو سکتے ہیں، لیکن ریپوزٹری تجویز کرتی ہے کہ تصدیق شدہ ٹولز کے بجائے انہیں غیر ثابت شدہ امکانات سمجھا جائے۔
دریافت کے ورک فلو کی مثالیں
روٹنگ آرکیٹیکچر کا انتخاب
فرض کریں کہ آپ کوڈنگ کے کاموں کو مناسب ماڈل کی طرف بھیجنا چاہتے ہیں۔ Classification and Routing سے آغاز کریں اور jev-router، prismhq's jev-router، اور pi-jev-router جیسے منصوبوں کا موازنہ کریں۔
ان کا جائزہ لیتے وقت یہ معلوم کریں:
- وہ امیدوار جن میں سے Jev کو انتخاب کی اجازت ہے۔
- ٹائپ شدہ سوال کے ساتھ بھیجی جانے والی حالت۔
- آیا کم اعتماد والے جوابات مسترد کیے جاتے ہیں یا اسکیلیٹ کیے جاتے ہیں۔
- کون سا جزو فیصلے پر عمل درآمد کرتا ہے۔
- آیا موجودہ چیٹ کا سیاق و سباق غیر تبدیل شدہ رہتا ہے۔
یہ موازنہ قابلِ دوبارہ استعمال پیٹرن کو انضمام سے متعلق مخصوص تفصیلات سے الگ کرنے میں مدد دیتا ہے۔
حفاظتی گیٹ ڈیزائن کرنا
ٹول کال گیٹ کے لیے ایسے منصوبوں کا مطالعہ کریں جو قطعی قواعد، Jev کے فیصلوں، اور انسانی جائزے کو یکجا کرتے ہیں۔ مثال کے طور پر، فہرست میں شامل pi-verdict منصوبہ واضح صورتِ حال کے لیے قطعی قواعد اور غیر واضح کالز کے لیے ٹائپ شدہ اجازت دیں، پوچھیں، یا انکار کریں کے انتخاب کا استعمال کرتا ہے۔ اس کی بیان کردہ پالیسی خرابیوں یا ٹائم آؤٹ کی صورت میں انکار کرتی ہے اور پوچھیں کے نتیجے کو انسان کی طرف بھیج دیتی ہے۔
اس سے ایک عمومی آرکیٹیکچر کی تجویز ملتی ہے:
incoming action
-> deterministic checks
-> typed Jev decision for ambiguous cases
-> confidence or policy evaluation
-> allow, block, or human confirmation
-> logged outcomeیہ خاکہ قابلِ منتقلی پیٹرن ہے، آفاقی تشکیل نہیں۔ موزوں قواعد متعین کرنے کے لیے ماخذ منصوبے کی دستاویزات اور اپنے خطرے کے ماڈل کا استعمال کریں۔
درجہ بندی کی پائپ لائن بنانا
درجہ بندی کے منصوبے دکھاتے ہیں کہ Jev کے فیصلے روایتی ایپلیکیشن کوڈ کی تکمیل کیسے کر سکتے ہیں۔ فہرست میں شامل Jev Search کی مثال میں Jev کے فیصلے نتائج کی مطابقت کا اندازہ لگاتے ہیں، جبکہ ایپلیکیشن کوڈ نقل شدہ URLs کو یکجا کرتا اور کم اسکور والے نتائج کو گروپ کرتا ہے۔ jev-reranker میں فیصلے نتائج کو ترتیب دینے اور اختیاری طور پر قابلِ تشکیل حد کے ذریعے فلٹر کرنے سے پہلے مطابقت اور ثبوت کے طور پر افادیت، دونوں کا اندازہ لگاتے ہیں۔
لہٰذا ایک عملی درجہ بندی کی پائپ لائن قطعی ذمہ داریاں کوڈ میں رکھ سکتی ہے:
- امیدوار ریکارڈز جمع کریں۔
- انہیں معمول پر لائیں اور نقلیں ختم کریں۔
- ٹائپ شدہ مطابقت یا افادیت کا سوال پوچھیں۔
- واپس آنے والے نتیجے یا احتمال کے مطابق ترتیب دیں۔
- اگر فلٹرنگ ضروری ہو تو دستاویزی حد نافذ کریں۔
- مسترد اور منظور شدہ امیدواروں کے معائنے کے لیے کافی میٹا ڈیٹا محفوظ رکھیں۔
فہرست استعمال کرنے کے لیے جدید تجاویز
مکمل ایپلیکیشنز نقل کرنے کے بجائے پیٹرنز اخذ کریں
کسی اندراج کا سب سے زیادہ قابلِ دوبارہ استعمال حصہ اس کا فریم ورک، زبان یا صارف انٹرفیس نہیں بلکہ اس کی فیصلہ کن حد ہو سکتی ہے۔ امیدواروں کے انتخاب، اعتماد کی سطح سے آگاہ درجہ بندی، متعین پیشگی فلٹرز، محدود اقدامات، ٹائم آؤٹ کے متبادل طریقوں اور انسانی جائزے کی قطاروں جیسی بار بار آنے والی ساختوں کو تلاش کریں۔
فیصلے کو عمل درآمد سے الگ رکھیں
فہرست میں شامل کئی ٹولز Jev کو ایک محدود فیصلہ تیار کرنے کے لیے استعمال کرتے ہیں، جبکہ عام کوڈ حدوں، وزنوں، ضمنی اثرات اور آخری اقدامات کو کنٹرول کرتا ہے۔ یہ علیحدگی عمل درآمد کی پالیسی کو جانچنا آسان بناتی ہے اور کسی ماڈل کے نتیجے کو خودکار طور پر لامحدود اختیار حاصل کرنے سے روکتی ہے۔
محدود امیدواروں کے مجموعے کو ترجیح دیں
روٹنگ، براؤزر آٹومیشن اور روبوٹکس کی مثالیں عموماً دستیاب اقدامات کو محدود کرتی ہیں۔ معلوم امیدواروں میں سے ٹائپ شدہ انتخاب کی توثیق کرنا غیر محدود طور پر تیار کردہ ہدایات کی نسبت آسان ہے۔ کسی پروجیکٹ کو اپنانے سے پہلے واضح کریں کہ کون سے اقدامات منتخب کیے جا سکتے ہیں اور غیر معتبر آؤٹ پٹ سے کیسے نمٹا جاتا ہے۔
کم اعتماد والی صورتِ حال پہلے ڈیزائن کریں
صرف کامیاب راستہ متعین نہ کریں۔ فیصلہ کریں کہ کم اعتماد کی صورت میں انسانی جائزہ شروع ہونا چاہیے، موجودہ حالت برقرار رہنی چاہیے، کسی دوسرے نظام کو فعال کرنا چاہیے یا عمل درآمد روک دینا چاہیے۔ فہرست میں ایسی مثالیں شامل ہیں جو کمزور مہارت کے میل کو مسترد کرتی ہیں، غیر یقینی ترکیبوں کو انسانی جائزے کے لیے بھیجتی ہیں، یا خود مختاری کی جانچ اپنی حدیں پوری نہ کرنے پر اختیار صارف کو واپس کر دیتی ہیں۔
ناکامی کے طریقوں کی جانچ کریں
ٹائم آؤٹ، API کی خرابیوں، ناقص فیصلوں، غیر دستیاب امیدواروں اور مبہم ان پٹس کا جائزہ لیں۔ حفاظت کے حوالے سے حساس ورک فلو میں ایک واضح متبادل طریقہ ہونا چاہیے۔ فہرست میں شامل کچھ گیٹس خرابیوں یا ٹائم آؤٹ کی صورت میں رسائی مسترد کرتے ہیں، جبکہ دوسرے نظام متعین متبادل حالات میں ایجنٹ کو فعال کرتے ہیں۔ درست پالیسی اس بات پر منحصر ہے کہ ناکامی کی صورت میں نظام کو کھلا چھوڑنا یا بند کرنا زیادہ خطرہ پیدا کرتا ہے۔
رپورٹ کردہ اعداد و شمار کو احتیاط سے دیکھیں
کچھ اندراجات تاخیر، درستگی، ٹوکن، لاگت یا منظرنامہ جاتی ٹیسٹ کے نتائج بیان کرتے ہیں۔ ہر عدد کے سیاق و سباق کو برقرار رکھیں۔ اسموک ٹیسٹ لازماً بینچ مارک نہیں ہوتا، اور کسی ریپوزٹری کا خود رپورٹ کردہ نتیجہ آزادانہ توثیق نہیں ہوتا۔ فن تعمیر کے بارے میں فیصلے کرنے سے پہلے اہم پیمائشیں اپنے ورک لوڈ کے ساتھ دوبارہ حاصل کریں۔
زمرہ جاتی فائلوں کو براہِ راست ٹریک کریں
چونکہ روٹ README ایک مجموعی دستاویز ہے، اس لیے بار بار کی جانے والی تحقیق کے لیے زمرہ جاتی فائلیں زیادہ مرکوز جائزہ فراہم کرتی ہیں۔ اگر آپ بنیادی طور پر گارڈ ریلز پر کام کرتے ہیں تو categories/verification-guardrails.md کو مانیٹر کریں۔ SDK یا گیٹ وے کے کام کے لیے categories/infra-sdks-integrations.md کو مانیٹر کریں۔
درستگیاں یا پروجیکٹس جمع کرانا
اگر کوئی اندراج غلط، ناقابلِ رسائی یا اب قواعد پر پورا نہ اترتا ہو تو مسئلہ یا پل ریکویسٹ کھولیں۔ کسی اندراج کو ہٹانا بھی اتنا ہی درست تعاون سمجھا جاتا ہے جتنا نیا اندراج شامل کرنا۔
جمع کرانے سے پہلے AI کی مدد سے کیے گئے کام اور بڑی تعداد میں جمع کرائی جانے والی تجاویز کے لیے تعاون کے قواعد کا جائزہ لیں۔ مجوزہ اندراج میں Jev کا براہِ راست استعمال ہونا چاہیے، کوئی ٹھوس پروجیکٹ یا قابلِ تکرار طریقۂ کار پیش کرنا چاہیے، عوامی طور پر قابلِ رسائی رہنا چاہیے اور ایک بنیادی زمرے میں موزوں ہونا چاہیے۔
اچھی شراکت میں متعلقہ عمل درآمدی کوڈ، قابلِ اجرا مثالوں، ٹیسٹس، مقداری دعووں کے شواہد اور واضح لائسنس کے روابط شامل ہونے چاہییں تاکہ تصدیق آسان ہو۔
نتیجہ
awesome-jev-tools کو پیکیج کیٹلاگ یا توثیقی فہرست کے بجائے دریافت کے نقشے کے طور پر استعمال کرنا زیادہ بہتر ہے۔ ایک واضح ٹائپ شدہ فیصلے سے آغاز کریں، قریب ترین زمرہ دیکھیں، منسلک عمل درآمد کا معائنہ کریں، اس کے شواہد اور لائسنس کی تصدیق کریں، اور دوبارہ استعمال کے قابل سب سے چھوٹا فن تعمیر اخذ کریں۔ یہ طریقہ آپ کو موجودہ Jev ورک فلو سے سیکھنے میں مدد دیتا ہے، بغیر یہ فرض کیے کہ فہرست میں شامل ہر پروجیکٹ پروڈکشن کے لیے تیار ہے۔