منصوبے کے بارے میں

Stable Retro اوپن اے آئی کے gym-retro کا ایک کمیونٹی کے زیرِ انتظام فورک ہے، جو کلاسک ویڈیو گیمز کو ریانفورسمنٹ لرننگ کے لیے Gymnasium ماحول میں تبدیل کرتا ہے۔ چونکہ اصل پروجیکٹ مینٹیننس موڈ میں ہے، اس لیے نئی گیمز اور فیچرز یہاں قبول کیے جاتے ہیں۔ ایمولیٹڈ سسٹمز یہ پروجیکٹ متعدد ایمولیٹر کورز کو شامل کرتا ہے اور Linux، Windows اور Apple کے لیے پلیٹ فارم سپورٹ کی دستاویز کرتا ہے۔ شامل سسٹمز میں Atari 2600، NES، SNES، Nintendo 64، Nintendo DS، Game Boy/Color، Game Boy Advance، Sega Genesis، Master System، Sega CD، 32X، Saturn، Dreamcast، PC Engine اور آرکیڈ مشینیں شامل ہیں۔ کچھ کورز میں احتیاطی پہلو ہیں: Nintendo 64 کے لیے BUILD_N64=ON اور OpenGL ہیڈرز درکار ہیں؛ Sega Dreamcast کے لیے ہارڈویئر رینڈرنگ (ENABLE_HW_RENDER=ON) ضروری ہے، جو فی الحال صرف Linux پر دستیاب ہے؛ Gambatte (Game Boy) کو Apple Silicon arm64 پر بطور ڈیفالٹ چھوڑ دیا جاتا ہے۔ گیمز اور ماحول 1000 سے زائد گیمز مختلف اقسام میں شامل ہیں، جیسے پلیٹ فارمرز (Super Mario World، Sonic 2، Mega Man 2، Castlevania IV)، فائٹرز (Mortal Kombat Trilogy، Street Fighter II، Fatal Fury، King of Fighters '98)، اسپورٹس، پزل، شمپس، بیٹ-ایم-اپس، ریسنگ اور تجرباتی RPGs۔ ہر انٹیگریشن میں گیم کے اندرونی متغیرات کے لیے میموری لوکیشنز، ریوارڈ فنکشنز، ایپیسوڈ کے اختتام کی شرائط، لیول-اسٹارٹ سیو اسٹیٹس اور ROM ہیشز شامل ہوتے ہیں۔ ROMs اور کچھ BIOS فائلیں شامل نہیں ہیں اور صارف کو خود حاصل کرنی ہوں گی؛ ایک retro.import کمانڈ ہیشز کی جانچ کرتی ہے اور مماثل ROMs درآمد کرتی ہے۔ ایک غیر تجارتی Sega Genesis ROM، Airstriker، ٹیسٹنگ کے لیے شامل ہے۔ تنصیب اور استعمال Stable Retro Python 3.10 سے 3.14 تک سپورٹ کرتا ہے اور اسے PyPI سے یا براہ راست Git ریپوزٹری سے انسٹال کیا جا سکتا ہے۔ نئی ROMs، اسٹیٹس یا ایمولیٹر کورز کو شامل کرتے وقت ایڈیٹیبل انسٹالز تجویز کیے جاتے ہیں۔ پلیٹ فارم کے مخصوص دستاویزات Linux (Ubuntu/Debian، WSL2، N64 اور Dreamcast کور سیٹ اپ) اور macOS (Apple Silicon، Homebrew) کا احاطہ کرتے ہیں۔ ایک مثال Stable Baselines3 کا استعمال کرتے ہوئے Airstriker-Genesis ماحول پر PPO کے ساتھ Nature CNN کو ٹرین کرتی ہے، اور مزید جدید اسکرپٹس بیرونی طور پر لنک کیے گئے ہیں۔ ٹولنگ اور دستاویزات ایک انٹیگریشن ٹول نئی گیمز شامل کرنے میں مدد کرتا ہے، جس کے استعمال کی وضاحت کے لیے ایک ویڈیو پلے لسٹ موجود ہے۔ دستاویزات stable-retro.farama.org پر میزبانی کی جاتی ہیں اور انہیں زیرِ تعمیر کام قرار دیا گیا ہے۔ ٹیوٹوریلز Windows 11 کے ساتھ WSL2 اور ایک کسٹم RetroArch بلڈ چلانے کا احاطہ کرتے ہیں جو ٹرین شدہ ماڈلز کو پلیئر ان پٹ اوور رائیڈ کرنے دیتا ہے۔ معاون اسپیکس میں Windows 10/11 بذریعہ WSL2، macOS 10.13/10.14، Linux (manylinux1، Ubuntu 24.04 تجویز کردہ) اور SSE3 یا اس سے بہتر والے CPUs شامل ہیں۔ کمیونٹی اور تحقیق شراکتیں CONTRIBUTING.md، GitHub Issues اور Farama Foundation Discord کے ذریعے کی جاتی ہیں۔ README میں کئی تعلیمی مقالے درج ہیں جو stable-retro کا ذکر کرتے ہیں، جن میں ریانفورسمنٹ لرننگ ماحول، جنریٹو ورلڈ ماڈلز، LLM ایجنٹ بینچ مارکس اور گیم AI تحقیق شامل ہے۔