pokemon-player

Use the pokemon-agent package to run a headless PyBoy server with your ROM, then loop through observing game state via GET /state, taking screenshots for vision analysis, deciding actions, and posting button inputs to POST /action.

Clone NousResearch/pokemon-agent, create a Python 3.10+ virtual environment with uv or venv, install the package with the pyboy extra, then run pokemon-agent serve with --rom pointing to your ROM and --port 9876.

Yes, set up an SSH reverse tunnel through localhost.run forwarding local port 9876, then open the generated .lhr.life URL with /dashboard/ appended. The tunnel URL changes each time it restarts.

No, ROM files are never downloaded or provided. You must supply your own legally obtained .gb, .gbc, or .gba ROM file, which the server loads via the --rom flag.

RAM state only reports position and HP, not surroundings like ledges, doors, or NPCs. Take screenshots every 2-4 movement steps and use vision analysis, and add wait actions after door or stair warps to avoid stale position reads.

Save every 15-20 turns, and always before gym battles, rival encounters, new towns, or any uncertain action. Use POST /save with a descriptive name like before_brock so you can reload via POST /load if something goes wrong.