pokemon-player

Control a headless Pokemon emulator through a Python API.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/shuff57/agent-evo --skill pokemon-player-shuff57
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/shuff57/agent-evo/tree/main/skills/.archive/topics-2026-05-10/gaming/pokemon-player
Command: npx skills add https://github.com/shuff57/agent-evo --skill pokemon-player-shuff57

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyboy, and includes scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill solves the challenge of remotely controlling Pokemon games running in a headless emulator using a Python API.

Core Features & Use Cases

  • Play Pokemon Games: Use the Python pokemon-agent package to play games such as Red, Blue, Yellow, FireRed, and others.
  • Emulator Control: Perform gameplay actions such as moving, battling, saving, and loading the game.
  • User Interaction: Directly interface with the user through commands to initiate gameplay, retrieve game state, and display gameplay data.
  • Use Case: Integrate into automated game bots, testing scenarios, or provide an API for developers to interact with the game environment programmatically.

Quick Start

Initialize the Python environment with source .venv/bin/activate, and run the pokemon-agent serve command to start the server and set the necessary game configuration.

Frequently Asked Questions about pokemon-player

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

FAQPage Schema
How do I control a Pokemon emulator with Python?

You control a Pokemon emulator using Python via the `pokemon-agent` package, which provides an API to execute navigation, interaction, saving, and loading commands on headless game ROMs.

What is a headless Pokemon emulator used for in Python automation?

A headless Pokemon emulator runs game ROMs without a graphical interface, allowing Python scripts to automate gameplay, test game scenarios, or build AI-driven bots programmatically.

Which Pokemon games can I automate using Python scripts?

You can automate games such as Red, Blue, Yellow, and FireRed using Python scripts, provided you have the appropriate game ROMs configured with the emulator environment.

Does this Python Pokemon emulator control require the pyboy dependency?

Yes, controlling headless Pokemon games through this Python API requires the `pyboy` dependency to handle the underlying emulator execution and game state interactions.

How do I start a Python server to interact with Pokemon ROMs?

Initialize your Python environment with `source .venv/bin/activate`, then run the `pokemon-agent serve` command to start the server and configure the necessary game settings for ROM interaction.

Can I retrieve game state and display data from a headless Pokemon game?

Yes, you can retrieve game state and display gameplay data by using the Python API to interface directly with the headless emulator during automated bot execution or testing scenarios.