pokemon-player

Play Pokemon ROMs autonomously via headless emulation with RAM state monitoring.

1|Updated Jul 31, 2026
One-click install
npx skills add https://github.com/icyzh/hermes-web --skill pokemon-player-icyzh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/icyzh/hermes-web/tree/main/optional-skills/gaming/pokemon-player
Command: npx skills add https://github.com/icyzh/hermes-web --skill pokemon-player-icyzh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pokemon-agent, pyboy.

What problem does it solve?

This skill solves the challenge of interacting with legacy game environments by providing a headless emulation interface that allows an AI to observe, navigate, and play Pokemon games autonomously.

Core Features & Use Cases

  • Headless Emulation: Runs game ROMs in a background process with RAM-level state access.
  • Vision-Integrated Gameplay: Combines RAM state data with visual analysis to navigate complex game maps and handle battle logic.
  • Use Case: Use this skill to have an AI agent play through a Pokemon game, manage team progression, and handle gym battles while you monitor the progress via a live dashboard.

Quick Start

Start the pokemon-player skill by navigating to the agent directory and initiating the game server with your ROM file.

Frequently Asked Questions about pokemon-player

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

FAQPage Schema
How do I run headless Pokemon gameplay and let an AI play the game?

Headless Pokemon gameplay is enabled by running game ROMs in a background emulator process with RAM-level state access, allowing an AI to autonomously observe, navigate, and play. It combines RAM data with visual analysis for navigation and battle logic.

What do I need to set up a Python GameBoy emulator for autonomous gameplay?

To set up a Python GameBoy emulator for autonomous gameplay, you need a Python 3.10+ environment with the pokemon-agent and pyboy packages installed, plus a valid Pokemon ROM file to initiate the game server.

Does the pokemon-player skill support visual analysis for map navigation?

Yes, the skill supports vision-integrated gameplay by combining RAM state monitoring with visual analysis. This allows the AI to navigate complex game maps, handle gym battles, and manage team progression effectively.

Can I use this tool to monitor AI progression through gym battles?

You can monitor AI progression through gym battles using a live dashboard. The AI agent manages team progression and handles battle decision-making autonomously while you observe the gameplay results in real-time.

What are the limitations of using pyboy for AI gameplay analysis?

Using pyboy for AI gameplay analysis requires a valid ROM file and a Python 3.10+ environment to function. It is designed for headless background processing, meaning it operates without a standard graphical interface during autonomous play.