Awesome Jev کیا فراہم کرتا ہے
Awesome Jev، Jev کے ساتھ بنائے گئے پروجیکٹس کی ایک منتخب اور ماخذ سے پشتیبانی شدہ ڈائریکٹری ہے۔ Jev، TypeSafe AI کا System One ماڈل ہے۔ یہ ریپوزٹری خود کوئی SDK نہیں، بلکہ ڈویلپرز کو سرکاری وسائل، کمیونٹی کلائنٹس، ڈویلپر ٹولز، ورک فلو انٹیگریشنز، مظاہروں، نقلِ تجربات اور جائزاتی پروجیکٹس دریافت کرنے میں مدد دیتی ہے۔
Jev کو آزادانہ متن تیار کرنے کے بجائے محدود دائرے میں سافٹ ویئر فیصلوں کے لیے ڈیزائن کیا گیا ہے۔ یہ غیر ساختہ پروگرام اسٹیٹ کو ٹائپ شدہ سوالات کے ساتھ ملاتا ہے، پھر محدود جوابات اور متعلقہ احتمالات واپس کرتا ہے۔ ان جوابات کے ساتھ کیا کرنا ہے، اس کا فیصلہ ایپلیکیشن کوڈ کی ذمہ داری رہتا ہے۔
program state + typed questions
→ constrained answers + probabilities
→ deterministic application logicیہ ڈائریکٹری ایسے پروجیکٹس کو ترجیح دیتی ہے جن کا سورس کوڈ عوامی ہو، Jev کا ٹھوس استعمال دکھائی دے، حدود دستاویزی شکل میں موجود ہوں، اور شواہد کو دوبارہ پیش کیا جا سکے۔ درج شدہ اندراجات کا آخری جائزہ 18 ستمبر 2026 کو لیا گیا تھا، تاہم اس ماحولیاتی نظام کو نیا اور تیزی سے تبدیل ہونے والا بتایا گیا ہے۔
بنیادی فیصلہ جاتی عناصر کو سمجھیں
کسی پروجیکٹ کا انتخاب کرنے سے پہلے یہ شناخت کریں کہ آپ کی ایپلیکیشن کو کس قسم کا فیصلہ کرنا ہے۔ README میں سوالات کے تین بنیادی عناصر نمایاں کیے گئے ہیں۔
- Choice: ممکنہ جوابات کے محدود مجموعے میں سے انتخاب کرتا ہے۔ یہ درجہ بندی، روٹنگ، ابتدائی چھان بین اور کارروائی کے انتخاب کے لیے موزوں ہے۔
- Score: ایک محدود دائرے والا جائزہ تیار کرتا ہے جو درجہ بندی، ترجیح بندی اور معیار پر مبنی جانچ میں مدد دے سکتا ہے۔
- Noul: احتمالی ہاں، نہیں یا نامعلوم طرز کے فیصلے کی نمائندگی کرتا ہے۔ یہ تصدیق، مواد کی نگرانی، جانچ اور حفاظتی پابندیوں کے لیے معاون ہو سکتا ہے۔
یہ عناصر اس وقت مفید ہوتے ہیں جب قابلِ اجازت نتائج پہلے سے متعین کیے جا سکیں۔ Jev کو عام مقصد کے متن تیار کرنے والے کا متبادل نہیں سمجھا گیا۔
تصوری فیصلہ جاتی چکر
README میں SDK سے متعلق مخصوص نحو فراہم نہیں کی گئی، اس لیے درج ذیل براہِ راست قابلِ اجرا مثال کے بجائے تصوری pseudocode ہے۔
state = collect_relevant_program_state()
question = define_typed_question(
allowed_answers = ["route_a", "route_b", "abstain"]
)
result = ask_jev(state, question)
if result.probability >= validated_threshold:
apply_deterministic_action(result.answer)
else:
request_human_review()اہم نمونہ یہ ہے کہ Jev احتمالات کے ساتھ ایک محدود فیصلہ تجویز کرتا ہے، جبکہ عام ایپلیکیشن کوڈ حدوں، اجازتوں اور ضمنی اثرات کو نافذ کرتا ہے۔
آغاز کے لیے نقطۂ انتخاب کریں
کمیونٹی انٹیگریشن اپنانے سے پہلے سرکاری مواد سے آغاز کریں۔
- ماڈل کے انٹرفیس، شائع شدہ دعووں، مظاہروں اور احتیاطی نکات کے لیے System One اور Jev کا تعارف پڑھیں۔
- تصورات، بنیادی عناصر، API کی تفصیلات، نمونوں اور موجودہ SDK ہدایات کا جائزہ لینے کے لیے سرکاری دستاویزات استعمال کریں۔
- پروڈکٹ کے جائزے اور ابتدائی رسائی کے داخلی مقام کے لیے TypeSafe AI ملاحظہ کریں۔
- اپنے ایپلیکیشن اسٹیک کے مطابق سرکاری TypeScript اور JavaScript SDK یا Python SDK منتخب کریں۔
JavaScript اور TypeScript SDK جواب کی inferred اقسام فراہم کرتا ہے۔ Python SDK ہم وقت اور غیر ہم وقت دونوں استعمال کی معاونت کرتا ہے۔ فراہم کنندگان کے تقابل کے لیے سرکاری System One Python adapter Jev اور LLM فراہم کنندگان کے لیے ایک مشترکہ انٹرفیس پیش کرتا ہے۔
تنصیب اور سیٹ اپ
Awesome Jev ایک کیٹلاگ ہے، اس لیے اس کا کوئی مشترکہ ایپلیکیشن رن ٹائم یا عالمگیر تنصیب کمانڈ نہیں۔ سیٹ اپ کا انحصار آپ کے منتخب کردہ SDK یا پروجیکٹ پر ہوتا ہے۔ پرانے مفروضوں پر انحصار سے بچنے کے لیے یہ طریقۂ کار استعمال کریں۔
- برقرار رکھے جانے والے نفاذ کا انتخاب کریں۔ پہلی انٹیگریشن کے لیے سرکاری SDK کو ترجیح دیں، پھر مخصوص زبان یا فریم ورک کی ضرورت ہو تو کمیونٹی کلائنٹس پر غور کریں۔
- منتخب ریپوزٹری کھولیں۔ پیکیج کی تنصیب، توثیق، ماحولیاتی متغیرات اور ورژن کی ضروریات کے لیے اس کی اپنی README کی پیروی کریں۔
- موجودہ API دستاویزات سے رجوع کریں۔ درست constructors، request fields، response types اور غیر ہم وقت رویے کی تصدیق کریں۔
- کم سے کم ٹائپ شدہ سوال بنائیں۔ باہمی طور پر واضح نتائج کے ایک چھوٹے مجموعے سے آغاز کریں۔
- جوابات اور احتمالات ریکارڈ کریں۔ درستگی، حدوں، تاخیر اور دستبرداریوں کا جائزہ لینے کے لیے کافی شواہد محفوظ رکھیں۔
- متعین کنٹرولز شامل کریں۔ کسی احتمالی جواب کو اکیلے ناقابلِ واپسی یا زیادہ اثر والی کارروائی شروع کرنے کی اجازت نہ دیں۔
متبادل زبان اور فریم ورک کلائنٹس
ڈائریکٹری میں کئی ماحول کے لیے کمیونٹی انٹیگریشنز شامل ہیں۔ مثالوں میں Go کے لیے typesafe-go، Elixir اور OTP کے لیے jev، اور Laravel کے لیے laravel-typesafe-jev شامل ہیں۔ Python صارفین غیر ہم وقت jevclient کا بھی جائزہ لے سکتے ہیں۔
یہ پروجیکٹس اپنی الگ ریپوزٹریز، سیٹ اپ ہدایات اور لائسنس رکھتے ہیں۔ Awesome Jev میں شمولیت TypeSafe AI کی توثیق نہیں ہے۔
بنیادی Jev ورک فلو بنائیں
مرحلہ 1: محدود دائرۂ کار والا کام متعین کریں
ایسا فیصلہ منتخب کریں جس کے ممکنہ نتائج محدود ہوں۔ آغاز کے لیے موزوں کاموں میں آنے والی درخواست کو کسی قطار میں بھیجنا، کسی ریکارڈ کو معیار کے مطابق درجہ دینا، یہ جانچنا کہ شواہد کسی دعوے کی تائید کرتے ہیں یا نہیں، یا چند امیدواروں کی مختصر فہرست کی درجہ بندی کرنا شامل ہیں۔
روٹنگ کی تصوراتی تعریف کچھ یوں ہو سکتی ہے:
State:
incoming request, account context, policy metadata
Typed Choice:
billing | technical_support | abuse_review | unknown
Application rule:
route only when the selected answer meets a tested thresholdمرحلہ 2: متعلقہ حالت فراہم کریں
فیصلے کے لیے درکار معلومات فراہم کریں اور یہ توقع نہ رکھیں کہ ماڈل غائب حقائق خود گھڑ لے گا۔ پالیسی کے قواعد اور اہم پابندیاں واضح رکھیں۔ اگر اگلے اقدام کے لیے کوئی مطلوبہ ڈیٹا موجود نہ ہو تو اندازہ لگانے کے بجائے ورک فلو کو رکنے یا معاملہ آگے بھیجنے کی ہدایت دیں۔
مرحلہ 3: ٹائپ والا سوال پوچھیں
محدود درجہ بندی کے لیے Choice، محدود دائرے میں جائزے کے لیے Score، یا ہاں، نہیں، یا نامعلوم طرز کی جانچ کے لیے Noul استعمال کریں۔ درخواست کے درست فارمیٹ کے لیے منتخب کردہ SDK کی دستاویزات پر عمل کریں۔
مرحلہ 4: احتمال کی تشریح کریں
اسکیما کے مطابق درست جواب صرف یہ ثابت کرتا ہے کہ نتیجہ مطلوبہ ساخت میں ہے۔ یہ ثابت نہیں کرتا کہ فیصلہ درست ہے۔ واپس کیے گئے احتمال کو ایسی پالیسی کے لیے ان پٹ سمجھیں جسے لیبل شدہ مثالوں پر جانچا گیا ہو۔
if confident and action_is_allowed:
continue_workflow()
elif review_is_available:
send_to_human()
else:
stop_safely()مرحلہ 5: عمل درآمد کو تعینیت پسند رکھیں
اجازتوں، قانونی منتقلیوں، شرح کی حدود اور حفاظتی جانچوں کے نفاذ کے لیے روایتی کوڈ استعمال کریں۔ یہ علیحدگی خاص طور پر مواد کی نگرانی، کوڈ کے اجرا، ٹول کالز، طبعی آلات اور دیگر زیادہ اثر رکھنے والے کاموں کے لیے اہم ہے۔
عام استعمال کے معاملات پر Jev کا اطلاق کریں
معنوی روٹنگ
HTTP روٹنگ کے لیے hono-jev-router Hono درخواستوں کو ان کے مفہوم کے مطابق روٹ کرتا ہے۔ tiershift TypeScript اور Python کے لیے پالیسی کی حدود میں ماڈل روٹنگ پر توجہ دیتا ہے، جبکہ jev-codex-router ہر ٹرن کے لیے Codex ماڈل، استدلال اور رفتار کی ترتیبات منتخب کرتا ہے۔
ڈیٹا فلٹرنگ اور ابتدائی چھانٹی
jev-curate Parquet اور JSONL اسٹریمز کو فلٹر اور اسکور کرتا ہے۔ jevlogs زیادہ مہنگے تجزیے سے پہلے OpenTelemetry لاگز کی ابتدائی چھانٹی کرتا ہے۔ ڈیٹا بیس پر مبنی اختیارات میں pg-jev PostgreSQL ایکسٹینشن اور jevsql شامل ہیں، جو قدرتی زبان کے predicates کے ساتھ SQL جیسے فلٹرنگ، درجہ بندی، کلاسیفکیشن اور اسکورنگ فراہم کرتے ہیں۔
ایجنٹس اور حفاظتی پابندیاں
ایجنٹ پر مبنی منصوبے دکھاتے ہیں کہ ٹائپ والے فیصلے ماڈل اور اس کے ٹولز کے درمیان کیسے رکھے جا سکتے ہیں۔ jev-guard ٹول کالز کے لیے اجازت، پوچھیں یا انکار کے نتائج مقرر کرتا ہے۔ winnow Claude Code کے سیاق میں شامل کرنے سے پہلے ٹول کے نتائج کا جائزہ لیتا ہے، جبکہ Canny شواہد ریکارڈ کرتا ہے اور غیر معاون تکمیل کے دعووں کو چیلنج کرتا ہے۔
یہ طریقے اس وقت زیادہ مؤثر ہوتے ہیں جب فیصلہ سازی کی تہہ تعینیت پسند اجازت کاری کو نظرانداز نہ کر سکے۔ اجازت کا نتیجہ آنے کے بعد بھی اسے ایپلیکیشن کی حقیقی اجازت اور حفاظتی پالیسیوں کے خلاف جانچنا چاہیے۔
تعامل پر مبنی اور حقیقی وقت کے نظام
اس ڈائریکٹری میں کھیلوں اور روبوٹکس کے ایسے تجربات شامل ہیں جو احتمالی فیصلے کو تعینیت پسند دنیا کے قواعد سے الگ کرتے ہیں۔ typesafe-snake ہر گیم ٹک پر ایک ٹائپ والا فیصلہ کرتا ہے، جبکہ کوڈ قانونی چالیں تیار کرتا ہے۔ heist-one محافظوں کے فیصلے کے لیے Jev استعمال کرتا ہے، جبکہ تعینیت پسند کوڈ کھیل کی دنیا کو کنٹرول کرتا ہے۔ jev-drone MuJoCo کواڈروٹر تجربے میں سست حکمت عملی پر مبنی فیصلوں کا جائزہ لیتا ہے۔
قابلِ اعتماد فیصلوں کے لیے جدید تجاویز
اپنے ڈیٹا پر حدود کی کیلیبریشن کریں
کسی غیر متعلقہ مظاہرے سے اعتماد کی حد نقل نہ کریں۔ اپنے مطلوبہ ماحول سے لیبل شدہ مثالیں جمع کریں اور مختلف حدود پر نتائج کی پیمائش کریں۔ jevcal کو اعتماد کی حدود فٹ کرنے اور ڈرفٹ جانچنے کے آلے کے طور پر درج کیا گیا ہے۔
منتخب خطرے اور تاخیر کی پیمائش کریں
جب اعتماد ناکافی ہو تو نظام کو فیصلہ روکنے کی اجازت دیں۔ پھر قبول کیے گئے فیصلوں کی درستگی اور فال بیک کو بھیجے گئے معاملات کے تناسب، دونوں کی پیمائش کریں۔ jev-benchmarks کیلیبریشن، منتخب خطرے اور تاخیر پر مرکوز قابلِ تکرار جائزہ فراہم کرتا ہے۔
فیصلہ سازی کے طریقوں کا موازنہ کریں
یہ فیصلہ کرتے وقت کہ آیا Jev کسی کام کے لیے موزوں ہے، قابو میں رکھے گئے تقابل استعمال کریں۔ Janus یہ پیمائش کرتا ہے کہ Jev کو دوسرے ماڈلز کے مقابلے میں کب استعمال کرنا چاہیے اور اسی کے مطابق راستہ منتخب کرتا ہے۔ typesafe-ai-benchmark منصوبہ ایک LLM گیٹ وے فراہم کرتا ہے جو تقابلی کام کے لیے System One کے آؤٹ پٹ کی ساخت کی نقل کرتا ہے۔
بڑی درجہ بندیوں کو تکراری انداز میں سنبھالیں
جب کوئی درجہ بندی ماڈل کی براہِ راست اختیارات کی حد سے بڑی ہو، تو فیصلے کو کسی غیر محدود آؤٹ پٹ اسپیس کے بجائے محدود مراحل میں تقسیم کریں۔ jev-tree بڑی درجہ بندیوں میں تکراری انتخاب کی مثال پیش کرتا ہے۔
ساختی اور معنوی توثیق کو یکجا کریں
مقامی اسکیما کی توثیق اور معنوی فیصلہ سازی مختلف مسائل حل کرتے ہیں۔ zod-jev، Zod کی ساختی توثیق کو Jev کی معنوی توثیق کے ساتھ یکجا کرتا ہے۔ دونوں سطحیں موجود ہونے کے باوجود، نمائندہ ڈیٹا پر کام کی کارکردگی کی توثیق کریں۔
شواہد محفوظ رکھیں
ہر فیصلے کے لیے ان پٹ اسٹیٹ کا ورژن، ٹائپ شدہ سوال، مجاز جوابات، منتخب جواب، احتمال، حد، متبادل راستہ، اور حتمی قطعی کارروائی ریکارڈ کرنے پر غور کریں۔ اس سے آڈٹ، خرابی کا تجزیہ، کیلیبریشن، اور تبدیلیوں کی شناخت میں مدد ملتی ہے۔
اہم احتیاط: اسکیما کے مطابق درست نتیجہ لازماً درست فیصلہ نہیں ہوتا۔ اپنے ڈیٹا پر توثیق کریں، حدود کو کیلیبریٹ کریں، زیادہ اثر رکھنے والی کارروائیوں کو قطعی جانچ کے پیچھے رکھیں، اور انسانی متبادل فراہم کریں۔
اوپن متبادل نفاذ کو احتیاط سے جانچیں
یہ ڈائریکٹری آزاد Jev نما انٹرفیسز اور اوپن نفاذات کے روابط بھی فراہم کرتی ہے، جن میں openjev-sglang، jevmlx، openvons، اور openjev شامل ہیں۔ ان منصوبوں کو واضح طور پر TypeSafe کی سرکاری ریلیزز کے بجائے آزاد کوششوں کے طور پر بیان کیا گیا ہے۔
کسی اوپن متبادل نفاذ کا جائزہ لیتے وقت API مطابقت، ماڈل کی ضروریات، ہارڈویئر سپورٹ، پابندیوں کا نفاذ، احتمال کی کیلیبریشن، معاون موڈیلیٹیز، اور شائع کردہ حدود کی تصدیق کریں۔ یکساں آؤٹ پٹ ساختیں مساوی رویے کی ضمانت نہیں دیتیں۔
کسی منصوبے میں تعاون کریں
اگر آپ نے Jev کا کوئی منصوبہ بنایا ہے، تو ریپوزٹری کی CONTRIBUTING.md پڑھیں اور پل ریکویسٹ کھولیں۔ چھوٹے منصوبے بھی خوش آمدید ہیں، بشرطیکہ ان کا عوامی ماخذ ایک واضح اور عملی Jev فیصلہ جاتی لوپ دکھاتا ہو۔ کام، ٹائپ شدہ آؤٹ پٹس، احتمال سے نمٹنے کے طریقے، قطعی کنٹرولز، حدود، اور دوبارہ تیاری کے مراحل کی دستاویز بنائیں۔
Awesome Jev کو CC0 1.0 Universal کے تحت جاری کیا گیا ہے۔ ہر منسلک منصوبہ اپنا الگ لائسنس برقرار رکھتا ہے، اس لیے اس کے کوڈ کو استعمال یا تبدیل کرنے سے پہلے اس منصوبے کی شرائط کا جائزہ لیں۔
نتیجہ
Awesome Jev ابھرتے ہوئے System One ماحولیاتی نظام کا ایک عملی نقشہ ہے۔ اپنی زبان کے لیے سرکاری دستاویزات اور SDK سے آغاز کریں، ایک محدود ٹائپ شدہ فیصلہ بنائیں، اور عمل درآمد کو قطعی کنٹرول میں رکھیں۔ پروڈکشن میں استعمال سے پہلے نمائندہ ڈیٹا کا جائزہ لیں، حدود کو کیلیبریٹ کریں، عدمِ فیصلہ اور تاخیر کی پیمائش کریں، اور غیر یقینی یا اہم معاملات کے لیے ایک محفوظ انسانی متبادل برقرار رکھیں۔