pokemon-player

Plays Pokemon games via headless PyBoy emulation with RAM state reads and screenshot verification.

Updated May 13, 2026
One-click install
npx skills add https://github.com/superfhp/lumi-agent-body --skill pokemon-player-superfhp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/superfhp/lumi-agent-body/tree/main/skills/gaming/pokemon-player
Command: npx skills add https://github.com/superfhp/lumi-agent-body --skill pokemon-player-superfhp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pokemon-agent, pyboy.

What problem does it solve? Playing Pokemon autonomously requires coordinating an emulator, reading game state, making navigation decisions, and recovering from mistakes like getting lost or stuck on ledges. This Skill provides a complete operational playbook for running a headless Pokemon game server and playing it reliably through an observe-orient-decide-act loop. ## Core Features & Use Cases - Headless Game Server: Launches the pokemon-agent server with a user-provided ROM, exposing REST endpoints for state, screenshots, actions, and save/load management. - Vision-Guided Gameplay Loop: Combines RAM state reads with screenshot analysis every 2-4 moves to navigate maps, handle dialog, and avoid one-way ledges and building-exit traps. - Battle and Save Strategy: Includes a Gen 1 type chart, run/fight decision trees, and disciplined save conventions before gyms and risky encounters. - Use Case: A user says "play pokemon" and provides a Pokemon Red ROM; the Skill starts the server, opens a live dashboard tunnel via localhost.run, and plays through progression milestones from the starter choice to the Elite Four. ## Quick Start Ask the assistant to play pokemon with your ROM file, for example by saying "start pokemon with my pokemon_red.gb ROM and show me the live dashboard".

Frequently Asked Questions about pokemon-player

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I play Pokemon with a headless Game Boy emulator?▼

Clone the pokemon-agent repository, install it with the pyboy extra in a Python 3.10+ virtual environment, then run pokemon-agent serve with your ROM path and port 9876. The server exposes REST endpoints for state, screenshots, and actions.

How do I let someone watch the AI play Pokemon in a browser?▼

Create an SSH reverse tunnel through localhost.run forwarding local port 9876 to remote port 80 for nokey@localhost.run. Grep the tunnel log for the generated .lhr.life URL and append /dashboard/ to share the live view.

Can I use any Pokemon ROM with the pokemon-agent emulator?▼

The server accepts Game Boy ROM files such as .gb, .gbc, and .gba for titles like Pokemon Red, Blue, Yellow, and FireRed. You must supply your own ROM file, as ROMs are never downloaded or provided.

Why does the AI get lost or stuck when navigating Pokemon maps?▼

RAM state provides position and HP but not surroundings like ledges, doors, and NPCs, which are only visible in screenshots. Take a screenshot every 2-4 moves, wait after warp transitions, and sidestep after exiting buildings.

How do I save and resume a Pokemon game session?▼

POST to the /save endpoint with a descriptive name like before_brock, and reload it later via POST /load or the --load-state flag at server startup. GET /saves lists all available saved states.