PyBoy is a Game Boy emulator written in Python that can be used both as a standalone application and as a library for scripting and AI development.
The emulator solves the problem of running classic Game Boy games on modern systems while providing programmatic access to game state for automation and machine learning. It implements the Game Boy hardware in Python with performance optimizations through Cython and PyPy support. The tool allows developers to interact with running games through an API, inspect game memory and sprites, control input, and manipulate game state including rewinding to previous points.
Developers should choose this tool if they want to build AI agents to play Game Boy games, create bots, or automate gameplay testing. It suits projects involving reinforcement learning on retro games, as it provides direct access to game state and supports frame skipping to accelerate training. The emulator works as both a command-line player for casual use and as a library integrated into Python scripts, making it flexible for different use cases from casual play to serious AI research.
The project maintains active development with regular updates to the codebase. The maintainers prioritize performance optimization, offering frame-skipping capabilities to accelerate AI training and scripting workflows. Documentation is comprehensive, including API references, wiki pages with game-specific examples, and code examples covering multiple titles. The project maintains an active Discord community for user support and discussion.
