عن المشروع

Stable Retro هو نسخة متابعة مُدارة من قبل المجتمع لمشروع gym-retro الأصلي من OpenAI، والذي يحول ألعاب الفيديو الكلاسيكية إلى بيئات Gymnasium للتعلم المعزز. نظرًا لأن المشروع الأصلي في وضع الصيانة، يتم قبول الألعاب والميزات الجديدة هنا بدلاً من ذلك. الأنظمة المُحاكاة يضم المشروع عدة نوى محاكاة ويوثق دعم المنصات لكل من لينكس وويندوز وآبل. تشمل الأنظمة المغطاة أتاري 2600، NES، SNES، نينتندو 64، نينتندو DS، غيم بوي/كولر، غيم بوي أدفانس، سيغا جينيسيس، ماستر سيستم، سيغا CD، 32X، ساتورن، دريم كاست، PC إنجن وأجهزة الأركيد. بعض النوى لها تحفظات: نينتندو 64 يتطلب BUILD_N64=ON وملفات رؤوس OpenGL؛ سيغا دريم كاست يتطلب عرضًا ماديًا (ENABLE_HW_RENDER=ON) وهو حاليًا لينكس فقط؛ غامباتي (غيم بوي) يتم تخطيه افتراضيًا على 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)، الرياضة، الألغاز، العاب إطلاق النار، beat-em-ups، السباقات وألعاب تقمص الأدوار التجريبية. يتضمن كل تكامل مواقع ذاكرة للمتغيرات داخل اللعبة، ودوال مكافأة، وشروط نهاية الحلقة، وحالات حفظ عند بدء المستوى وتجزئة ROM. لا يتم تضمين ملفات ROM وبعض ملفات BIOS ويجب على المستخدم الحصول عليها؛ يقوم أمر الاستيراد retro.import بالتحقق من التجزئات واستيراد ملفات ROM المطابقة. يتم تضمين ROM غير تجاري لسيغا جينيسيس، Airstriker، للاختبار. التثبيت والاستخدام يدعم Stable Retro بايثون من الإصدار 3.10 حتى 3.14 ويمكن تثبيته من PyPI أو مباشرة من مستودع Git. يُنصح بالتثبيت القابل للتحرير عند دمج ملفات ROM أو حالات أو نوى محاكاة جديدة. توثق المنصات التعليمات الخاصة بلينكس (أوبونتو/ديبيان، WSL2، إعداد نوى N64 ودريم كاست) وماك (Apple Silicon، Homebrew). مثال يدرّب Nature CNN مع PPO على بيئة Airstriker-Genesis باستخدام Stable Baselines3، ويتم ربط نصوص أكثر تقدمًا خارجيًا. الأدوات والتوثيق أداة تكامل تساعد في إضافة ألعاب جديدة، مع قائمة تشغيل فيديو تشرح استخدامها. التوثيق مستضاف في stable-retro.farama.org ويُوصف بأنه عمل قيد التقدم. تغطي الدروس ويندوز 11 مع WSL2 وتشغيل بناء RetroArch مخصص يسمح للنماذج المدربة بتجاوز مدخلات اللاعب. تشمل المواصفات المدعومة ويندوز 10/11 عبر WSL2، ماك 10.13/10.14، لينكس (manylinux1، أوبونتو 24.04 موصى به) ومعالجات SSE3 أو أفضل. المجتمع والبحث تُوجه المساهمات من خلال CONTRIBUTING.md، وقضايا GitHub وخادم Discord لمؤسسة فاراما. يسرد README عدة أوراق أكاديمية تذكر stable-retro، تغطي بيئات التعلم المعزز، نماذج العالم التوليدية، معايير وكلاء LLM وأبحاث الذكاء الاصطناعي للألعاب.