PyBoy
github.com
- Free plan
- Windows
- macOS
- Linux
- API
- Self-hosted
What PyBoy is
PyBoy is a Game Boy and Game Boy Color emulator written in Python and Cython. It can run from the command line or be used inside Python programs for automation, testing, and AI experiments. Installation instructions give `pip install pyboy` and link to setup guidance for macOS, Linux, and Windows. Through its Python interface, programs can send button input, inspect memory, and capture screenshots. The documented hardware interface covers the CPU and address space, graphics, audio, cartridge hardware, and input; it does not include internal emulation components or platform-specific window implementations. Rendering may be skipped or disabled, and the documentation says parallel instances can improve throughput. The project also links to Gym integration instructions and examples using Kirby, Tetris, and Super Mario Land. PyBoy is free under the GNU Lesser General Public License version 3, and supports Windows 64-bit, macOS, Linux, and Raspberry Pi OS. Save states, link cable emulation, and a real-time clock are supported. The guide cautions that the project is under active development and advises keeping backup save files, particularly when upgrading.
Who it suits
PyBoy suits Python developers exploring Game Boy automation, testing, or AI experiments, as well as people who want command-line emulation. Its Python interface and hardware API are useful for projects that need to send input or inspect emulator state.
Good to know, and what to watch
- Free under the GNU Lesser General Public License version 3
- Python interface supports input, memory inspection, and screenshots
- Can skip rendering and run parallel instances
- Supports save states, link cable emulation, and real-time clock
- Under active development
- Guide advises backing up save files, especially before upgrades
Plans
Every plan and pricePyBoy
Free plan
The verdict
PyBoy pairs Game Boy emulation with a Python-facing interface for automation and experiments. Its active development makes keeping save backups especially important.
What the maker publishes
- API scope
- The API reference covers the supported Python-facing interface and intentionally excludes internal emulation components and platform-specific window implementations. source
- Hardware APIs
- The documented interface covers CPU and address space, graphics, audio, cartridge hardware, and input. source
- Installation
- The documentation gives `pip install pyboy` as the installation command. source
- Integration
- The GitHub README links to instructions for using PyBoy with Gym and provides examples for Kirby, Tetris, and Super Mario Land. source
- License
- The repository includes the GNU Lesser General Public License version 3. source
- Notable limit
- The guide says PyBoy is under active development and advises keeping backup copies of save files, especially when upgrading between releases. source
- Performance
- Rendering can be skipped or disabled, and the documentation says running multiple instances in parallel can improve throughput. source
- Platform support
- The installation page links to platform-specific instructions for macOS, Linux, and Windows. source
- Purpose
- PyBoy is a Game Boy emulator written in Python and Cython. source
- Python interface
- The Python interface can send button input, inspect memory, and capture screenshots. source
- Support
- The installation and development guide directs users to the PyBoy Discord for help. source
- Use cases
- It can be used from the command line or embedded in Python programs for automation, testing, and AI experiments. source
Checked against the maker's pages on 4 Oct 2026.