pokemon-player

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

16|Updated Sep 22, 2026
One-click install
npx skills add https://github.com/igniteenow/robo --skill pokemon-player-igniteenow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/igniteenow/robo/tree/main/optional-skills/gaming/pokemon-player
Command: npx skills add https://github.com/igniteenow/robo --skill pokemon-player-igniteenow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pokemon-agent, pyboy.

What problem does it solve? Playing a Game Boy Pokemon game autonomously requires coordinating an emulator, reading game state, making navigation and battle decisions, and letting the user watch progress live. This Skill orchestrates that entire loop through the pokemon-agent package so an AI agent can start, play, save, and resume a Pokemon session on request. ## Core Features & Use Cases - Headless emulation server: Starts pokemon-agent with a user-provided ROM on port 9876, exposing REST endpoints for state, screenshots, actions, and save/load. - Observe-decide-act gameplay loop: Combines RAM state reads with vision-analyzed screenshots to navigate maps, handle dialog, run from or fight battles, and avoid known traps like ledges and building exits. - Live dashboard sharing: Sets up an SSH reverse tunnel via localhost.run so the user can watch gameplay in a browser. - Use Case: A user says "play pokemon" and the agent boots Pokemon Red, picks a starter, delivers the Parcel, and works toward the Boulder Badge while saving progress before risky fights. ## Quick Start Say "play pokemon" and provide your own Game Boy ROM file so the agent can start the emulator and begin playing.

Frequently Asked Questions about pokemon-player

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

FAQPage Schema
How do I have an AI play Pokemon with an emulator?▼

Clone the pokemon-agent repository, install it in a Python 3.10+ virtual environment with the pyboy extra, then run pokemon-agent serve with your ROM on port 9876. The agent plays by reading RAM state and screenshots and posting actions to the server.

What tool is used for headless Game Boy emulation?▼

The pokemon-agent package built on PyBoy provides headless Game Boy emulation with a REST API. It exposes endpoints for game state, screenshots, actions, and save states, which the agent polls during its gameplay loop.

Can I use this without my own Pokemon ROM file?▼

No, you must supply your own ROM file such as a .gb, .gbc, or .gba dump. The Skill never downloads or provides ROM files, so you need a legally obtained copy before starting the server.

Why does the agent get lost or stuck while navigating?▼

RAM state reports position and HP but not surroundings like ledges, doors, or NPCs, so movement without screenshots fails. The Skill requires a screenshot with vision analysis every 2-4 steps and extra waits after warp transitions.

How are save states managed during gameplay?▼

Save states are created with POST /save using descriptive names and restored with POST /load or the --load-state startup flag. The Skill saves every 15-20 turns and always before gym battles or risky encounters.