PyBoy

What PyBoy is

PyBoy is a free Game Boy and Game Boy Color emulator written in Python and Cython. It can run from the command line or be embedded in Python programs for automation, testing, and AI experiments. Install it with `pip install pyboy`; setup instructions are linked for macOS, Linux, and Windows. Its Python interface can send button input, inspect memory, and capture screenshots. The documented hardware-facing interface covers the CPU and address space, graphics, audio, cartridge hardware, and input, while leaving internal emulation components and platform-specific window implementations outside its API reference.

Rendering can be skipped or disabled, and the documentation says parallel instances can improve throughput. The project links to Gym integration instructions and examples featuring Kirby, Tetris, and Super Mario Land. Supported platforms include Windows 64-bit, macOS, Linux, and Raspberry Pi OS. It also supports save states, link cable emulation, and a real-time clock. PyBoy is licensed under the GNU Lesser General Public License version 3. The project is under active development, and its guide advises keeping backup copies of save files, particularly when upgrading between releases.

Who it suits

PyBoy suits developers and experimenters who want to use Game Boy or Game Boy Color emulation from Python or the command line. Its input, memory, and screenshot interface can support automation and testing workflows.

Getting started

1. Install Python package PyBoy with `pip install pyboy`.
2. Use the platform-specific installation instructions for macOS, Linux, or Windows.
3. Run PyBoy from the command line or embed it in a Python program.
4. Use the Python interface for input, memory inspection, or screenshots.

Verdict

PyBoy offers a Python-facing emulator interface alongside command-line use and developer-oriented integration examples. Its development status makes keeping save backups particularly important when upgrading.