pokemon-player

Automate headless Pokemon gameplay by running an AI agent server that controls a ROM through RAM-state analysis and button inputs. The agent reads position and HP from RAM while using vision for environmental awareness, eliminating the need for a graphical interface.

Compatible ROMs for automated headless emulation include classic Gen 1 Pokemon games such as Red, Blue, and Yellow, as well as FireRed. The agent enforces ROM usage policies while applying RAM-state driven decisions to progress through these supported titles.

An AI agent reads game state during headless Pokemon emulation by extracting position, HP, and other variables directly from RAM. It supplements this RAM-state analysis with vision support to maintain environmental awareness and drive automated input decisions.

You can run a headless Pokemon game server in the background by loading a ROM with a specified port. The server supports monitoring gameplay remotely through a live dashboard accessible via a tunnel, allowing you to observe the automated gameplay loop without a GUI.

The gameplay loop logic for an AI agent playing Pokemon autonomously follows a cycle of observe, orient, decide, act, verify, and save progress to memory. This loop tracks milestones and generates gameplay analytics while continuously issuing button inputs to the ROM.