pokemon-player

Plays Pokemon games autonomously via headless PyBoy emulation with RAM state reading and vision-based navigation.

1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill pokemon-player-kaminocorp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/kaminocorp/hermes-alpha-hunter/tree/main/skills/gaming/pokemon-player
Command: npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill pokemon-player-kaminocorp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pokemon-agent, pyboy.

What problem does it solve? Playing a Pokemon game through an emulator requires constant manual input and attention. This Skill automates the entire gameplay loop — reading game state from emulator RAM, making strategic battle and navigation decisions, and sending button inputs — so an AI agent can play Pokemon Red, Blue, or Yellow autonomously from the terminal. ## Core Features & Use Cases - Headless Emulation Server: Starts a pokemon-agent game server backed by PyBoy, exposing HTTP endpoints for state, screenshots, actions, and save/load management. - Structured Gameplay Loop: Follows an observe-orient-decide-act-verify cycle combining RAM state data with vision-based screenshot analysis for reliable navigation. - Battle Strategy & Progression: Applies Gen 1 type matchups, battle decision trees, and gym-by-gym progression milestones, with periodic save states before risky encounters. - 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, battles through Viridian Forest, saves before Brock's gym, and streams a live dashboard link — all unattended. ## Quick Start Ask the agent to "play pokemon" and provide the path to your own legally obtained Game Boy ROM file so it can start the emulation server 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 make an AI play Pokemon automatically?▼

Use the pokemon-agent package, which runs a headless PyBoy emulation server exposing HTTP endpoints for game state, screenshots, and button inputs. The agent follows an observe-decide-act loop, sending short action sequences and verifying movement with vision analysis after every few steps.

What emulator is used for headless Pokemon gameplay?▼

The skill uses PyBoy, a Python-based Game Boy emulator, installed as an extra of the pokemon-agent package. It runs headlessly and exposes RAM state, screenshots, and input control through a local HTTP server on port 9876.

Can I use any Pokemon ROM with this setup?▼

Yes, Game Boy titles like Pokemon Red, Blue, and Yellow work via .gb ROM files passed with the --rom flag. You must supply your own legally obtained ROM — the skill never downloads or provides ROM files.

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

RAM state provides position and HP but not surroundings like ledges, doors, or NPCs, so navigation fails without screenshots. The skill requires taking a screenshot every 2-4 movement steps and adding extra waits after door or stair warp transitions.

How do I save and resume Pokemon progress?▼

Send a POST request to the /save endpoint with a descriptive name like before_brock, and reload it later via POST /load or the --load-state startup flag. The skill saves every 15-20 turns and always before gym battles or risky encounters.