pokemon-player

Automate Pokemon gameplay by controlling a headless emulator and reading RAM state.

31|3|Updated May 7, 2026
One-click install
npx skills add https://github.com/markwang2658/hermes-windows-native --skill pokemon-player-markwang2658
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/markwang2658/hermes-windows-native/tree/main/hermes-agent/optional-skills/gaming/pokemon-player
Command: npx skills add https://github.com/markwang2658/hermes-windows-native --skill pokemon-player-markwang2658

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates Pokemon gameplay by controlling a headless emulator and reading RAM state.

Core Features & Use Cases

  • Headless gameplay control using the pokemon-agent package to run Pokemon ROMs without a GUI.
  • RAM-state driven observation combined with a vision component to guide decisions, saving and loading progress, and a live dashboard workflow.
  • Use Case: imagine an AI agent playing Pokemon Red via a local server, saving progress after gym battles and streaming decisions to a user.

Quick Start

Clone the Pokemon agent repository, create and activate a Python 3.10+ virtual environment with the required dependencies, place a ROM in roms directory, install dependencies, and start the server pointing to that ROM.

Frequently Asked Questions about pokemon-player

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

FAQPage Schema
How do I automate Pokemon gameplay using a headless emulator?

Automating Pokemon gameplay involves controlling a headless emulator and reading RAM state to guide AI decisions. This Skill uses the pokemon-agent package to run classic ROMs without a GUI, enabling automated play, state checks, and save or load management.

What is RAM-driven AI play for Pokemon emulation?

RAM-driven AI play reads game memory state directly from the emulator to inform automated decisions. Combined with optional vision assistance, it allows an AI agent to observe the game environment and execute actions like navigating menus or battling.

Do I need Python 3.10+ to run the pokemon-agent package?

Yes, Python 3.10+ is required to run the pokemon-agent package. You must create and activate a virtual environment, install the necessary dependencies including pyboy, and place a valid ROM file in the roms directory before starting the server.

How do I set up a local server to expose endpoints for Pokemon AI automation?

Setting up the server requires cloning the Pokemon agent repository, configuring a Python 3.10+ environment, placing a ROM in the roms directory, and starting the server. It exposes endpoints for state checks, screenshots, saving, and loading progress.

Can I use vision-assisted decision making with headless Pokemon gameplay?

Yes, vision-assisted decision making is supported alongside RAM-state driven observation. While the headless emulator runs without a GUI, the system can process screenshots to optionally guide AI decisions during gameplay.

What are the limitations of automating Pokemon ROMs with RAM reading?

Automating Pokemon ROMs requires a valid ROM file and a correctly configured Python environment with pyboy. It is limited to classic Pokemon games supported by the emulator and depends on server endpoints for state checks and progress saving.