pokemon-player

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

164|28|Updated Mar 5, 2026

Search Tags:#ai-agent #websocket #pokemon #rest-api #emulator #game-server #headless-emulation

Ready to run

npx skills add https://github.com/NousResearch/pokemon-agent --skill pokemon-player-nousresearch

💬 Prompt for ChatGPT / Claude Chat▼

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.