pokemon-player

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

Updated Jun 30, 2026
One-click install
npx skills add https://github.com/zhoulingxiao1216/testworkspace --skill pokemon-player-zhoulingxiao1216
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/zhoulingxiao1216/testworkspace/tree/main/all_Skills/gaming/pokemon-player
Command: npx skills add https://github.com/zhoulingxiao1216/testworkspace --skill pokemon-player-zhoulingxiao1216

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pokemon-agent, pyboy.

What problem does it solve? Playing Pokemon through an emulator requires constant visual feedback and state tracking that text-only automation cannot provide. This Skill runs Pokemon games headlessly via the pokemon-agent package, combining RAM state reads with screenshot-based vision analysis so an AI can navigate, battle, and progress through the game autonomously. ## Core Features & Use Cases - Headless Game Server: Starts a pokemon-agent server with a user-provided ROM, exposing REST endpoints for state, screenshots, actions, and save/load management. - Vision-Guided Gameplay Loop: Follows an observe-orient-decide-act-verify cycle, taking screenshots every few moves to avoid getting lost on the map. - Battle and Save Strategy: Includes Gen 1 type matchups, run/fight decision trees, and disciplined save points before gyms and risky encounters. - Use Case: A user says "play pokemon" and the AI boots Pokemon Red, sets up a live dashboard tunnel so the user can watch, then plays through Brock's gym while saving progress along the way. ## Quick Start Ask the AI to play pokemon with your ROM file and it will start the emulator server and give you a live dashboard link to watch.

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 an AI using a headless emulator?▼

Clone the pokemon-agent repository, create a Python 3.10+ virtual environment, and install the package with the pyboy extra. Then run pokemon-agent serve with your ROM file and port 9876, and the AI plays via the REST API.

What emulator does pokemon-agent use for Game Boy games?▼

pokemon-agent uses PyBoy, a Python-based Game Boy emulator, installed as an extra dependency. It runs headlessly and exposes game state through RAM reads plus screenshot endpoints for vision analysis.

Can I watch the AI play Pokemon in my browser?▼

Yes, the setup uses an SSH reverse tunnel through localhost.run to expose the local dashboard. After connecting, you receive a .lhr.life URL with /dashboard/ appended, though the URL changes each time the tunnel restarts.

Does the Pokemon player provide or download ROM files?▼

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

Why does the AI get stuck or lost while navigating in Pokemon?▼

RAM state only reports position and HP, not surroundings like ledges, doors, or NPCs. The Skill mitigates this by taking screenshots every 2-4 moves, waiting after warp transitions, and sidestepping after exiting buildings.

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

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