
اہم: Astra-Ares ایک تجرباتی ریفرنس امپلیمنٹیشن ہے۔ یہ ایک الگ، پیچ شدہ Codex CLI چلاتا ہے اور بنیادی طور پر تجربات یا ان ڈویلپرز کے لیے بنایا گیا ہے جو اپنے ایجنٹ سسٹمز میں موافق استدلالی کوشش شامل کرنا چاہتے ہیں۔
Astra-Ares کیا کرتا ہے
Astra-Ares، Codex ٹاسک کے دوران GPT-6 Astra کے لیے موافق استدلالی کوشش کا انتخاب شامل کرتا ہے۔ پورے ٹاسک کے لیے ایک مقررہ استدلالی سطح مختص کرنے کے بجائے، یہ Jev نامی جائزہ کار کے ذریعے طے کرتا ہے کہ Astra کو اگلے مرحلے پر کتنی استدلالی کوشش کرنی چاہیے۔
Jev محدود ٹاسک سیاق کا جائزہ لیتا ہے، اگلی کوشش کی سطح منتخب کرتا ہے، اور فیصلہ کرتا ہے کہ یہ انتخاب 1، 2، 5، یا 10 ماڈل جنریشنز تک فعال رہنا چاہیے۔ اس کے بعد Codex کام جاری رکھنے سے پہلے Astra کے مقامی کنفیگریشن طریقۂ کار کے ذریعے اس انتخاب کو نافذ کرتا ہے۔
Astra اپنے کیش کے لیے استعمال ہونے والے اصل پرامپٹ سابقے کو غیر مؤثر کیے بغیر استدلالی کوشش تبدیل کر سکتا ہے۔ اسی لیے Ares خود کو Astra کے نیٹ ورک راستے میں شامل کرنے کے بجائے وہی ماڈل، گفتگو، اور براہِ راست OpenAI کنکشن برقرار رکھتا ہے۔ عام پرامپٹ کیش کی اہلیت اور برقرار رکھنے کے قواعد بدستور لاگو رہتے ہیں۔
اہم خصوصیات
- موافق استدلال: Jev ایک مقررہ ترتیب پر انحصار کرنے کے بجائے ٹاسک کے اگلے حصے کے لیے درکار کوشش کا انتخاب کرتا ہے۔
- متعدد جنریشنز کے لیز: کوئی فیصلہ 1، 2، 5، یا 10 جنریشنز تک فعال رہ سکتا ہے، جس سے غیر ضروری جائزہ کار کی درخواستیں کم ہوتی ہیں۔
- Codex میں مقامی اطلاق: پیچ شدہ CLI جنریشنز کے درمیان Astra کی ترتیبات نافذ کرتا ہے اور کامیاب اطلاق کی تصدیق کرتا ہے۔
- محدود جائزہ کار سیاق: Jev کو ٹاسک، عوامی پیش رفت، استدلالی خلاصے، اور حالیہ ٹول نتائج کا محدود مجموعہ موصول ہوتا ہے۔
- براہِ راست Astra کنکشن: Codex براہِ راست OpenAI سے رابطہ جاری رکھتا ہے۔ Jev ایک الگ کنفیگر کردہ فراہم کنندہ استعمال کرتا ہے۔
- الگ تھلگ تنصیب: Astra-Ares اپنا Codex پروفائل استعمال کرتا ہے اور موجودہ
codexکمانڈ یا Codex ڈیسک ٹاپ ایپلیکیشن کو تبدیل نہیں کرتا۔ - واضح ناکامی کا انتظام: Ares خاموشی سے فراہم کنندگان تبدیل نہیں کرتا، ماڈلز کا متبادل استعمال نہیں کرتا، اور کوشش کا فیصلہ خود سے ایجاد نہیں کرتا۔
انسٹال کرنے سے پہلے
پہلی بلڈ میں کئی منٹ اور تقریباً 10 GB خالی جگہ درکار ہوتی ہے۔ درج ذیل پیشگی تقاضے انسٹال کریں:
- Node.js 22 یا اس کے بعد کا ورژن
- npm
- Git
- curl
- tar
- مقامی C/C++ بلڈ ٹول چین
- rustup کے ذریعے Rust
سیٹ اپ کا عمل اپ اسٹریم Codex سورس کے ذریعے مقرر کردہ Rust ٹول چین بھی انسٹال کرتا ہے۔ macOS پر، اگر Xcode Command Line Tools موجود نہ ہوں تو انہیں انسٹال کریں:
xcode-select --install
Apple Silicon پر macOS کو مقامی طور پر بلڈ اور ٹیسٹ کیا جا چکا ہے۔ Intel macOS اور Linux کے لیے بلڈ کے راستے موجود ہیں، لیکن ابھی تک ان کی قبولیتی جانچ نہیں کی گئی۔ Windows سپورٹڈ نہیں ہے کیونکہ یہ انضمام Unix sockets پر منحصر ہے۔
مرحلہ 1: Astra-Ares کی بلڈ اور تنصیب
سورس ریپوزٹری کلون کریں، اس کے Node.js انحصارات انسٹال کریں، خودکار سیٹ اپ چلائیں، اور عالمی کمانڈ لنکس بنائیں:
git clone https://github.com/miuuyy/Astra-Ares.git
cd Astra-Ares
npm ci
npm run setup
npm link
سیٹ اپ مقرر کردہ Codex ورژن ڈاؤن لوڈ کرتا ہے، شامل کردہ پیچ نافذ کرتا ہے، اور اسے خودکار طور پر بلڈ کرتا ہے۔ آپ کو Codex میں دستی ترمیم کرنے کی ضرورت نہیں۔
npm link کمانڈ آپ کے ٹرمینل میں دو کمانڈز دستیاب کراتی ہے: astra-ares اور ares۔ یہ پیش نظارہ سورس سے تقسیم کیا جاتا ہے؛ فی الحال کوئی شائع شدہ npm پیکیج یا پہلے سے بلڈ شدہ Ares ڈاؤن لوڈ دستیاب نہیں۔ تازہ کاریوں، بلڈ کے دوبارہ استعمال، حذف کرنے، اور عالمی لنک کے بغیر آپریشن کے لیے پروجیکٹ کی تنصیبی دستاویزات دیکھیں۔
مرحلہ 2: Jev فراہم کنندہ کی کنفیگریشن
نئی تنصیبات میں بطور ڈیفالٹ OpenRouter کو Jev فراہم کنندہ کے طور پر استعمال کیا جاتا ہے۔ ایک OpenRouter API key بنائیں، یقینی بنائیں کہ اس کے اکاؤنٹ میں کافی کریڈٹس موجود ہیں، اور کنفیگریشن پرامپٹ شروع کریں:
ares configure
کلید پوشیدہ پرامپٹ میں پیسٹ کریں۔ Astra-Ares اسے کلون کی گئی ریپوزٹری سے باہر، آپ کی نجی صارف کنفیگریشن میں محفوظ کرتا ہے۔
Jev کی اسناد Astra تک رسائی کے لیے استعمال ہونے والے Codex اکاؤنٹ سے الگ ہیں۔ اگر پیچ شدہ CLI کو تصدیق درکار ہو تو اس کمانڈ سے سائن اِن کریں:
astra-ares login
دیگر Jev فراہم کنندگان اور ماحول کے متغیرات کے اختیارات پروجیکٹ کی کنفیگریشن گائیڈ میں بیان کیے گئے ہیں۔
مرحلہ 3: موافق استدلال کے ساتھ Codex لانچ کریں
پیچ شدہ Codex ٹرمینل شروع کریں:
astra-ares
مقامی /model پکر کھولیں اور Astra-Jev منتخب کریں۔ نئے Ares پروفائلز بطور ڈیفالٹ اسی اندراج کو منتخب کرتے ہیں۔ اس کے بعد آپ ٹولز، منظوریوں، منسوخی، اور تاریخ سمیت معمول کے Codex ورک فلو کے ذریعے ٹاسک بھیج سکتے ہیں۔
جب Jev کوشش کی سطح تبدیل کرتا ہے اور Codex اس کی تصدیق کرتا ہے تو ٹرانسکرپٹ میں اس سے ملتا جلتا پیغام دکھائی دیتا ہے:
Jev LOW → HIGH ✓ APPLIED
Step 3 · next 2 generation(s) · 321 ms
APPLIED صرف سفارش کا اطلاع نامہ نہیں ہے: اس کا مطلب ہے کہ Codex نے تصدیق کی ہے کہ اگلی جنریشن کے لیے ترتیبات نافذ کر دی گئی ہیں۔ اطلاع مقامی اطلاق کے بعد ظاہر ہوتی ہے۔
بنیادی استعمال کی مثالیں
کسی مخصوص ریپوزٹری کو کھولیں
کسی مخصوص پروجیکٹ ڈائریکٹری میں کام شروع کرنے کے لیے -C استعمال کریں:
astra-ares -C /path/to/project
آخری Ares سیشن دوبارہ شروع کریں
astra-ares resume --last
Ares ایک علیحدہ Codex پروفائل استعمال کرتا ہے، اس لیے یہ کمانڈ عام Codex انسٹالیشن کے کسی سیشن کے بجائے اسی پروفائل سے آخری سیشن دوبارہ شروع کرتی ہے۔
Jev کلید تبدیل کریں
ares configure
ایک سیشن کے لیے Jev غیر فعال کریں
/model کھولیں اور عام Astra یا کوئی دوسرا ماڈل منتخب کریں۔ Codex، Jev روٹنگ کے بغیر کام جاری رکھے گا۔
Adaptive Selection کیسے کام کرتا ہے
- ماڈل کی جنریشن سے پہلے Codex کسی اہل چیک پوائنٹ تک پہنچتا ہے۔
- Ares ایسا محدود سیاق تیار کرتا ہے جس میں کام، عوامی پیش رفت، اور حالیہ ٹول سرگرمی شامل ہوتی ہے۔
- Jev ایک reasoning effort اور 1، 2، 5، یا 10 جنریشنز کی لیز منتخب کرتا ہے۔
- Codex، Astra کے مقامی configuration mechanism کے ذریعے منتخب کردہ ترتیبات نافذ کرتا ہے۔
- Astra جواب تیار کرتا ہے اور ایک یا زیادہ ٹولز طلب کر سکتا ہے۔
- لیز ختم ہونے یا کوئی واقعہ اسے غیر مؤثر بنانے پر Ares ایک اور فیصلہ طلب کرتا ہے۔
ایک مرحلے سے مراد ایک ماڈل جنریشن ہے، ایک ٹول کال نہیں۔ ایک جنریشن کئی ٹول کالز پیدا کر سکتی ہے۔ فیصلے اگلی جنریشن سے پہلے، دستیاب ٹول نتائج کے گفتگو میں شامل ہونے کے بعد کیے جاتے ہیں۔
Jev اس بات کا جائزہ لیتا ہے کہ صارف کے مقصد کے لحاظ سے اگلے مرحلے میں کتنی reasoning درکار ہے۔ مثال کے طور پر، فائل پڑھنا خود بخود کم effort کا جواز نہیں بنتا، کیونکہ فائل کی تشریح مشکل حصہ ہو سکتی ہے۔
لیز کو سمجھنا
اگر Jev دس جنریشنز کی لیز منتخب کرتا ہے تو Ares مرحلہ 1 پر فیصلہ طلب کرتا ہے اور پھر مرحلہ 11 پر دوبارہ طلب کرتا ہے۔ مراحل 2 سے 10 تک اضافی Jev درخواستوں کے بغیر منظور شدہ انتخاب دوبارہ استعمال ہوتا ہے۔
نیا صارف ان پٹ آنے، کسی ٹول کے ناکام ہونے، ماڈل تبدیل ہونے، یا reasoning effort دستی طور پر تبدیل کیے جانے پر لیز وقت سے پہلے ختم ہو جاتی ہے۔ اس کے بعد اگلے اہل چیک پوائنٹ پر Jev سے مشورہ کیا جاتا ہے۔ ٹول کی ناکامی دوبارہ جائزے کی درخواست کرتی ہے؛ یہ hardcoded escalation شروع نہیں کرتی۔
Jev کو ملنے والا سیاق
Jev کو Astra کا مکمل غیر محدود داخلی سیاق نہیں ملتا۔ اس کے evaluator view میں شامل ہوتا ہے:
- اصل یا موجودہ کام اور محفوظ شدہ سابقہ صارف درخواستیں
- عوامی پیش رفت، منصوبے، اور شائع شدہ reasoning خلاصے
- آخری چھ ٹول کالز اور ان کے متعلقہ نتائج
- ہر ٹول کال کے لیے مشترکہ نتیجہ متن کے زیادہ سے زیادہ 1,000 مقامی ٹوکن، واضح head-and-tail truncation کے ساتھ
- 28,000 مقامی ٹوکن کی حد سے محفوظ مکمل evaluator درخواست
نجی یا encrypted reasoning شامل نہیں کی جاتی۔ حد سے بڑے evaluator requests کو خاموشی سے بھیجنے کے بجائے واضح طور پر روک دیا جاتا ہے۔ مقامی tokenizer بجٹ کا تخمینہ فراہم کرتا ہے اور ضروری نہیں کہ Jev کے tokenizer سے یکساں ہو۔ یہ حدود صرف Jev کے view پر لاگو ہوتی ہیں؛ Astra اپنی مقامی گفتگو برقرار رکھتا ہے۔
محدود task context، configured Jev provider کو بھیجا جاتا ہے۔ حساس project data استعمال کرنے سے پہلے configuration اور logging documentation کا جائزہ لیں۔
تشخیص اور خرابیوں کا ازالہ
مقامی انسٹالیشن چیک کریں
ares doctor
یہ ذیل میں بیان کردہ provider probe کو جان بوجھ کر چلائے بغیر مقامی طور پر انسٹالیشن اور configuration چیک کرتا ہے۔
Jev Provider کی جانچ کریں
ares doctor --probe
یہ probe ایک چھوٹی، billable Jev درخواست بھیجتا ہے۔ اسے اس وقت استعمال کریں جب مقامی چیکس کامیاب ہوں لیکن evaluator فیصلے ناکام ہو رہے ہوں۔
فیصلوں کے لاگز دیکھیں
بطور ڈیفالٹ، run logs یہاں محفوظ ہوتے ہیں:
~/.local/share/astra-ares/runs/<run>/decisions.jsonl
یہ ریکارڈ ناکام provider requests، فیصلے کے وقت، اور نافذ کردہ ترتیبات کی شناخت میں مدد دے سکتے ہیں۔
HTTP 429 کو درست طور پر سمجھیں
HTTP 429 response rate یا capacity rejection کی نشاندہی کرتا ہے۔ یہ اکیلا اس بات کا ثبوت نہیں کہ evaluator context بہت بڑا ہے۔ عارضی HTTP errors کو 30 سیکنڈ کی deadline کے اندر اسی provider کے خلاف تین سے زیادہ attempts نہیں دیے جاتے۔
اگر تمام attempts ناکام ہو جائیں تو Ares موجودہ turn کو واضح طور پر روک دیتا ہے۔ یہ خاموشی سے کسی دوسرے provider پر منتقل نہیں ہوتا، کوئی دوسرا model منتخب نہیں کرتا، اور effort level خود سے نہیں بناتا۔ مزید checks کے لیے repository کی troubleshooting guide دیکھیں۔
اعلیٰ درجے کے نکات
Responsiveness اور Evaluator Cost میں توازن رکھیں
نیا Jev فیصلہ provider round trip اور مقامی checkpoint processing شامل کرتا ہے۔ فعال لیز کے دوران checkpoints مقامی طور پر سنبھالے جاتے ہیں اور دوسری Jev درخواست نہیں بھیجی جاتی۔ اس لیے طویل لیزیں درخواستوں کی تعدد کم کر سکتی ہیں، اگرچہ reference implementation میں بیان کردہ مدت Jev منتخب کرتا ہے، صارف نہیں۔
Integration کی توثیق کرتے وقت نمایاں تصدیقات استعمال کریں
Adaptive behavior کی جانچ کرتے وقت یہ فرض کرنے کے بجائے APPLIED status تلاش کریں کہ Jev کی سفارش Astra تک پہنچ گئی ہے۔ یہ confirmation صرف Codex کے native setting نافذ کرنے کے بعد جاری ہوتی ہے۔
موجودہ Measurement Limits یاد رکھیں
پروجیکٹ میں settings application اور prompt-prefix preservation کے لیے native fixture tests شامل ہیں۔ تاہم workload cache-hit rates اور fixed reasoning effort کے مقابلے میں savings ابھی ناپی نہیں گئی ہیں۔ efficiency claims کو ایک design goal سمجھیں جسے اپنے workloads پر validate کیا جانا چاہیے۔
Development Test Suite چلائیں
Contributors dependencies انسٹال کر کے standard tests اس طرح چلا سکتے ہیں:
npm ci
npm test
Native integration fixtures کے لیے اضافی طور پر Bun اور patched Codex binary درکار ہیں:
JEV_TEST_BINARY="$HOME/.local/share/astra-ares/bin/codex" npm run test:native
Local fixture tests کے لیے API keys درکار نہیں۔ upstream source checksums اور patch version patches/upstream.json میں pinned ہیں۔
نتیجہ
Astra-Ares یہ ظاہر کرتا ہے کہ ایک ایجنٹ نسلوں کے درمیان GPT-6 Astra کی استدلالی کوشش کو کیسے ایڈجسٹ کر سکتا ہے، جبکہ موجودہ گفتگو، براہِ راست OpenAI کنکشن، اور اصل پرامپٹ کا سابقہ برقرار رہتا ہے۔ اس کا خودکار سیٹ اپ تجربے کو قابلِ رسائی بناتا ہے، تاہم یہ اب بھی ایک ابتدائی تکنیکی پیش نظارہ ہے جو الگ سے پیچ کیے گئے Codex CLI کے گرد بنایا گیا ہے۔ اسے روزمرہ کے ترقیاتی ٹول کے طور پر استعمال کرنے سے پہلے اس کی تشخیصی سہولیات استعمال کریں، اس کے فیصلہ جاتی لاگز کا جائزہ لیں، اور اپنی ورک لوڈز پر کارکردگی کی توثیق کریں۔
