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.