pokemon-player

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

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill pokemon-player-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/optional-skills/gaming/pokemon-player
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill pokemon-player-vivekgoquest

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 decisions, and recovering from mistakes — this Skill provides a complete operational playbook for running an AI-controlled Pokemon session through the pokemon-agent server. ## Core Features & Use Cases - Headless Emulation Control: Starts and manages a pokemon-agent server backed by PyBoy, exposing REST endpoints for state, screenshots, actions, and save/load. - Structured Gameplay Loop: Defines an observe-orient-decide-act-verify cycle combining RAM state reads with vision-based screenshot analysis to avoid getting lost. - Battle and Progression Strategy: Includes a Gen 1 type chart, gym-by-gym progression milestones, save/load discipline, and memory conventions (PKM: prefixes) for cross-session continuity. - Use Case: A user says "play pokemon" — the agent sets up the emulator with the user's ROM, exposes a live dashboard via a localhost.run tunnel, and plays through Pokemon Red while saving progress before every gym battle. ## Quick Start Ask the agent to "play pokemon" and provide your own legally obtained Game Boy ROM file so it can start the emulator and 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 make an AI play Pokemon with an emulator?▼

Clone the NousResearch/pokemon-agent repository, install it with the pyboy extra in a Python 3.10+ virtual environment, then run pokemon-agent serve with your ROM. The agent interacts through REST endpoints for state, screenshots, and actions.

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

The pokemon-agent package uses PyBoy, a headless Game Boy emulator, installed as an optional extra. It exposes game state through RAM reads and an HTTP API on a configurable port.

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

No, you must supply your own legally obtained ROM file (.gb, .gbc, or .gba). The Skill explicitly never downloads or provides ROM files and will always ask the user for one.

How do I watch the AI play Pokemon in my browser?▼

The Skill sets up an SSH reverse tunnel through localhost.run, forwarding the local dashboard port to a public .lhr.life URL. Append /dashboard/ to the generated URL to watch live gameplay.

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 requires taking screenshots every 2-4 movement steps and using vision analysis to verify position and plan routes.

How does save and load work during a Pokemon playthrough?▼

The server exposes POST /save and POST /load endpoints with descriptive save names, plus GET /saves to list states. The Skill mandates saving every 15-20 turns and always before gym battles or risky encounters.