pokemon-player

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

Updated May 4, 2026
One-click install
npx skills add https://github.com/Junkfooooood/hermes-governance --skill pokemon-player-junkfooooood
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/Junkfooooood/hermes-governance/tree/main/skills/gaming/pokemon-player
Command: npx skills add https://github.com/Junkfooooood/hermes-governance --skill pokemon-player-junkfooooood

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 and battle decisions, and avoiding common traps like ledges, warps, and dialog stalls. This Skill provides a complete operational playbook for running a headless Pokemon agent reliably. ## Core Features & Use Cases - Headless Emulation Server: Starts the pokemon-agent server with a user-provided ROM, exposing REST endpoints for state, screenshots, actions, and save/load. - Vision-Guided Gameplay Loop: Combines RAM state reads with screenshot analysis every few steps to navigate maps, handle dialog, and avoid getting lost. - Battle and Progression Strategy: Includes Gen 1 type matchups, run/fight decision trees, save discipline, and gym-by-gym milestone planning. - Use Case: A user says "play pokemon" and the AI boots the emulator, opens a live dashboard tunnel for the user to watch, and plays through Pokemon Red while saving progress before every gym battle. ## Quick Start Say "play pokemon" and provide your own Pokemon 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 play Pokemon with an AI agent?

Say "play pokemon" and provide your own ROM file. The agent clones the pokemon-agent package, starts a headless emulator server on port 9876, and plays using RAM state reads plus screenshot verification.

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

The pokemon-agent package uses PyBoy, a Python Game Boy emulator, installed via the pyboy extra. It runs headless and exposes REST endpoints for state, screenshots, actions, and save states.

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

Yes. The setup creates an SSH reverse tunnel through localhost.run that forwards the local dashboard to a public .lhr.life URL. Append /dashboard/ to the URL to watch gameplay in real time.

Where do I get a Pokemon ROM file for the emulator?

You must supply your own legally obtained ROM file (.gb, .gbc, or .gba). The Skill never downloads or provides ROM files and will always ask you to provide one.

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

RAM state only reports position and HP, not surroundings like ledges, doors, or NPCs. The agent must take screenshots every 2-4 steps, wait after warp transitions, and sidestep after exiting buildings to stay oriented.

How does the agent save and resume Pokemon progress?

It saves via POST /save with descriptive names before risky encounters and every 15-20 turns. To resume, restart the server with the --load-state flag pointing to the saved state name.