Skip to main content

A python interface for training Reinforcement Learning bots to battle on pokemon showdown.

Project description

The pokemon showdown Python environment

CircleCI codecov License: MIT Code style: black Documentation Status

A python interface for training Reinforcement Learning bots to battle on pokemon showdown.

This project aims at providing a Python environment for interacting in pokemon showdown battles, with reinforcement learning in mind.

Documentation and examples

Documentation and detailed examples can be found here.

Examples and starting code can be found here.


This project requires python >= 3.6 and a Pokemon Showdown server.

pip install poke-env

You can use smogon's server to try out your agents against humans, but having a development server is strongly recommended. In particular, this showdown fork is optimized for performance and can be used locally without authentication:

git clone

Development version

You can also install the latest master version with:

git clone

Dependencies and development dependencies can then be installed with:

pip install -r requirements.txt
pip install -r requirements-dev.txt


This project is a follow-up of a group project from an artifical intelligence class at Ecole Polytechnique.

You can find the original repository here. It is partially inspired by the showdown-battle-bot project. Of course, none of these would have been possible without Pokemon Showdown.


Data files are adapted version of the js data files of Pokemon Showdown.


License: MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for poke-env, version 0.1.2
Filename, size File type Python version Upload date Hashes
Filename, size poke_env-0.1.2-py3-none-any.whl (182.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size poke_env-0.1.2.tar.gz (167.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page