Об этом проекте

Stable Retro — это поддерживаемый сообществом форк gym-retro от OpenAI, который превращает классические видеоигры в среды 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), спорт, головоломки, шутеры, beat-em-up, гонки и экспериментальные RPG. Каждая интеграция включает адреса памяти для внутриигровых переменных, функции вознаграждения, условия завершения эпизода, сохранения состояния начала уровня и хеши ROM. ROM и некоторые файлы BIOS не включены и должны быть получены пользователем; команда retro.import проверяет хеши и импортирует подходящие ROM. Некоммерческий ROM для Sega Genesis, Airstriker, включён для тестирования. Установка и использование Stable Retro поддерживает Python с 3.10 по 3.14 и может быть установлен из PyPI или напрямую из Git-репозитория. Редактируемая установка рекомендуется при интеграции новых ROM, состояний или эмуляторных ядер. Документация для конкретных платформ охватывает Linux (Ubuntu/Debian, WSL2, настройку ядер N64 и Dreamcast) и macOS (Apple Silicon, Homebrew). Пример обучает Nature CNN с PPO в среде Airstriker-Genesis с использованием Stable Baselines3, а более продвинутые скрипты доступны по внешним ссылкам. Инструменты и документация Инструмент интеграции помогает добавлять новые игры, с видеоплейлистом, объясняющим его использование. Документация размещена на stable-retro.farama.org и описывается как находящаяся в разработке. Учебные материалы охватывают Windows 11 с WSL2 и запуск пользовательской сборки RetroArch, которая позволяет обученным моделям переопределять ввод игрока. Поддерживаемые спецификации включают Windows 10/11 через WSL2, macOS 10.13/10.14, Linux (manylinux1, рекомендуется Ubuntu 24.04) и процессоры с SSE3 или новее. Сообщество и исследования Вклад направляется через CONTRIBUTING.md, GitHub Issues и Discord Farama Foundation. В README перечислены несколько научных работ, упоминающих stable-retro, охватывающих среды обучения с подкреплением, генеративные модели мира, бенчмарки LLM-агентов и исследования игрового ИИ.