Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

PyBoy

github.com

  • Free plan
  • Windows
  • macOS
  • Linux
  • API
  • Self-hosted
7.4 Club score Visit github.com

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

PyBoy

Free

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.