pokemon-player

Start the pokemon-agent server with your ROM file using the serve command on port 9876, then the AI loops through observing game state, taking screenshots, deciding actions, and posting moves. A live dashboard tunnel lets you watch gameplay in your browser.

It uses PyBoy, a Game Boy emulator, wrapped by the pokemon-agent package which exposes an HTTP API for state reads, screenshots, actions, and save states. The package requires Python 3.10 or later with the pyboy extra installed.

Yes, it supports Game Boy ROM files such as .gb, .gbc, and .gba formats including Pokemon Red, Blue, Yellow, and FireRed. You must supply your own ROM file, as the skill never downloads or provides ROMs.

RAM state only reports position and HP, not surroundings like ledges, doors, or NPCs, so movement without screenshots causes overshooting or loops. The skill mitigates this by taking screenshots every 2-4 steps and waiting extra frames after warp transitions.

Send a POST request to the /save endpoint with a descriptive name to create a save state, and use POST /load or the --load-state startup flag to resume. The /saves endpoint lists all available saved states.