pokemon-player

Automate Pokémon gameplay through a headless emulator and REST/WebSocket APIs.

164|28|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/NousResearch/pokemon-agent --skill pokemon-player-nousresearch
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/NousResearch/pokemon-agent/tree/main/skill
Command: npx skills add https://github.com/NousResearch/pokemon-agent --skill pokemon-player-nousresearch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates autonomous Pokémon gameplay by coupling a headless emulator with a REST/WebSocket API, enabling AI agents to run end-to-end game sessions without a GUI.

Core Features & Use Cases

  • Headless gameplay: Run Pokémon games without a display server, using a server-driven loop.
  • API-driven control: Read game state and issue actions via HTTP and WebSocket streams.
  • Agent-agnostic: Works with any AI agent, RL framework, or custom script.

Quick Start

Start the Pokémon game server with a ROM file, then control gameplay by reading state and sending actions through 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 Pokémon gameplay using a headless emulator?▼

Run Pokémon gameplay autonomously by starting a headless emulator server and controlling it through REST and WebSocket APIs, enabling AI agents to execute decision loops without a display server.

Can I use my own AI agent or RL framework with a Pokémon game server?▼

Yes, the Pokémon game server is agent-agnostic. Any AI agent, reinforcement learning framework, or custom script can connect to read game state and submit actions through the HTTP API.

What do I need to set up an autonomous Pokémon game server for AI testing?▼

Setting up an autonomous Pokémon game server requires the pokemon-agent package, a compatible Pokémon ROM file, and access to the server's HTTP API for state queries and action submission.

How do WebSocket streams and REST APIs handle emulator state and actions?▼

The REST API queries current game state, while WebSocket streams handle continuous emulator state updates and action submissions, enabling real-time server-and-agent workflows for autonomous gameplay.

Is a display server required to run end-to-end Pokémon AI experiments?▼

No, a display server is not required. The headless emulator operates without a GUI, allowing AI agents to run end-to-end game sessions and strategy testing purely through server-driven loops.