pokemon-player

Control a headless emulator and read RAM state to automate Pokemon gameplay.

27|2|Updated Jan 15, 2024
One-click install
npx skills add https://github.com/erfanzar/Xerxes-Agents --skill pokemon-player-erfanzar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/erfanzar/Xerxes-Agents/tree/main/src/python/xerxes/skills/pokemon-player
Command: npx skills add https://github.com/erfanzar/Xerxes-Agents --skill pokemon-player-erfanzar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates Pokemon gameplay by controlling a headless emulator and reading RAM-based game state to drive autonomous play.

Core Features & Use Cases

  • Start and run a local Pokemon-agent server that serves a ROM and port for automation.
  • Observe RAM-state and screen output to make strategic decisions and input button presses.
  • Use cases include AI play sessions, demonstrations, and tutor-friendly experiments with classic Gen 1 games.

Quick Start

Clone the pokemon-agent repo, set up a Python 3.10+ virtual environment, install dependencies, and start the server with --rom pointing to your ROM and --port to expose the API.

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 with a headless emulator?

Automate Pokemon gameplay by controlling a headless emulator and reading RAM-based game state. An observe-decide-act loop captures screen data and RAM state to make strategic decisions and send button inputs to the emulator.

What do I need to run a local Pokemon agent server for AI play?

Running a local Pokemon agent server requires Python 3.10+ with a virtual environment, a Pokemon ROM file, and an open local port. You must clone the agent repo, install dependencies, and start the server pointing to the ROM.

How does RAM-state observation work for Pokemon automation?

RAM-state observation reads live memory values from the headless emulator to understand the current game context. Combined with screen output, this data feeds into the agent's observe-decide-act loop to determine strategic button inputs.

Can I use this Python automation tool for Gen 1 Pokemon games?

Yes, this Python automation tool supports classic Gen 1 Pokemon games. It is designed for AI play sessions, demonstrations, and tutor-friendly experiments using a local server and RAM observation.

What are the limitations of using RAM state and screen data for Pokemon AI?

Limitations include dependency on a local server environment and the need for a valid ROM file. The agent relies entirely on RAM-state and screen data outputs, restricting its use to supported Gen 1 titles without external API integration.