stable-retro-apple-silicon 0.9.16

Apple Silicon wheels for stable-retro without bundled ROM payloads

🎮 Native Apple Silicon wheels for retro game reinforcement learning 🍎

🔍 Overview

The Pain: Installing stable-retro on Apple Silicon means building from source — fighting CMake, missing dependencies, and wasted hours.

The Solution: Pre-built arm64 wheels published to PyPI. One pip install and you're running retro game environments natively.

The Result: Go from zero to training in under 60 seconds on your M-series Mac.

SNES note: on Apple Silicon, SNES uses an automatic Rosetta helper because the native arm64 snes9x path is not stable across the bundled integrations. If Rosetta is not installed yet, install it once with:

softwareupdate --install-rosetta --agree-to-license

🚀 Quick Start

pip install stable-retro-apple-silicon

import stable_retro as retro

env = retro.make("Alleyway-GameBoy-v0", render_mode="rgb_array")

The deprecated compatibility alias still works:

import retro

✨ What You Get

• Native Apple Silicon wheels published to PyPI
• Matching downloadable wheel files attached to GitHub Releases
• A maintained Apple Silicon packaging layer on top of upstream stable-retro
• The same stable_retro and retro import surface users expect
• Automatic Rosetta fallback for SNES on Apple Silicon so bundled SNES integrations keep rendering correctly

📦 Release Matrix

Item	Value
Package	stable-retro-apple-silicon
CPU	Apple Silicon arm64
macOS	14.0+
Python	3.9 to 3.12
Wheel contents	code, public cores, game metadata
Public cores	Game Boy, NES, SNES, Sega Master System

🔧 Build Notes

• Apple Silicon wheel builds use a restricted public core set: gambatte, fceumm, snes9x, genesis_plus_gx
• CapnProto is disabled in the public wheel build path
• Release automation publishes wheels to PyPI and also attaches them to GitHub Releases

📚 Upstream Docs

The underlying project is stable-retro, so the upstream documentation remains relevant for APIs and integration metadata:

• Supported emulators
• Supported games/envs
• macOS installation notes
• Linux installation notes

📋 Publishing

See PUBLISHING.md for the release checklist and local wheel verification commands.