इस प्रोजेक्ट के बारे में

Stable Retro OpenAI के gym-retro का एक समुदाय-अनुरक्षित फोर्क है, जो क्लासिक वीडियो गेम्स को reinforcement learning के लिए Gymnasium वातावरण में बदलता है। चूंकि मूल प्रोजेक्ट maintenance mode में है, इसलिए नए गेम और सुविधाएँ यहाँ स्वीकार की जाती हैं। एमुलेटेड सिस्टम यह प्रोजेक्ट कई एमुलेटर कोर बंडल करता है और 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), स्पोर्ट्स, पज़ल, श्मप्स, बीट-एम-अप्स, रेसिंग और प्रायोगिक RPG। प्रत्येक इंटीग्रेशन में इन-गेम वेरिएबल्स के लिए मेमोरी लोकेशन, रिवॉर्ड फ़ंक्शन, एपिसोड समाप्ति शर्तें, लेवल-स्टार्ट सेवस्टेट और ROM हैश शामिल हैं। ROM और कुछ BIOS फ़ाइलें शामिल नहीं हैं और उपयोगकर्ता को स्वयं प्राप्त करनी होंगी; retro.import कमांड हैश की जाँच करता है और मेल खाते ROM आयात करता है। परीक्षण के लिए एक गैर-व्यावसायिक Sega Genesis ROM, Airstriker, बंडल किया गया है। इंस्टॉलेशन और उपयोग Stable Retro Python 3.10 से 3.14 तक का समर्थन करता है और इसे PyPI से या सीधे Git रिपॉजिटरी से इंस्टॉल किया जा सकता है। नए ROM, स्टेट या एमुलेटर कोर को एकीकृत करते समय editable इंस्टॉल की अनुशंसा की जाती है। प्लेटफ़ॉर्म-विशिष्ट दस्तावेज़ Linux (Ubuntu/Debian, WSL2, N64 और Dreamcast कोर सेटअप) और macOS (Apple Silicon, Homebrew) को कवर करते हैं। एक उदाहरण Stable Baselines3 का उपयोग करके Airstriker-Genesis वातावरण पर Nature CNN के साथ PPO को प्रशिक्षित करता है, और अधिक उन्नत स्क्रिप्ट बाहरी रूप से लिंक की गई हैं। टूलिंग और दस्तावेज़ीकरण एक इंटीग्रेशन टूल नए गेम जोड़ने में मदद करता है, जिसके उपयोग को समझाने वाली एक वीडियो प्लेलिस्ट है। दस्तावेज़ीकरण stable-retro.farama.org पर होस्ट किया गया है और इसे कार्य प्रगति पर बताया गया है। ट्यूटोरियल Windows 11 को WSL2 के साथ और एक कस्टम RetroArch बिल्ड चलाने को कवर करते हैं जो प्रशिक्षित मॉडलों को प्लेयर इनपुट को ओवरराइड करने देता है। समर्थित स्पेक्स में Windows 10/11 WSL2 के माध्यम से, macOS 10.13/10.14, Linux (manylinux1, Ubuntu 24.04 अनुशंसित) और SSE3 या बेहतर वाले CPU शामिल हैं। समुदाय और शोध योगदान CONTRIBUTING.md, GitHub Issues और Farama Foundation Discord के माध्यम से निर्देशित किए जाते हैं। README में कई अकादमिक पेपर सूचीबद्ध हैं जो stable-retro का उल्लेख करते हैं, जिनमें reinforcement-learning वातावरण, जनरेटिव वर्ल्ड मॉडल, LLM एजेंट बेंचमार्क और गेम AI शोध शामिल हैं।