pikapro
A fast, deterministic Pokémon battle simulator for Python, with a reinforcement-learning environment and a Showdown client built on it.
pikapro runs pikapro-engine, a Rust
port of Pokémon Showdown's battle simulator (Gen 9 singles and doubles,
VGC, Pokémon Champions), checked against Showdown down to every random
number drawn. Battles run on Rust threads with the GIL released.
pikapro.Battleandpikapro.BattlePoolare the simulator.pikapro.rlis the environment:nbattles per call, each player seeing only what a Showdown client knows. It has adapters for Gymnasium, PettingZoo and Stable-Baselines3.pikapro.showdownplays a policy trained inpikapro.rlon a local Showdown-protocol server or VGC Arena.pikapro.compat.poke_envruns unmodified poke-env players onpikaprobattles, in-process.
Install
pip install pikapro # needs only numpy
pip install 'pikapro[gym]' # + Gymnasium; also [pettingzoo], [sb3], [poke-env], [showdown], [all]
Wheels for CPython 3.10+ on Linux (x86_64, aarch64; glibc and musl), macOS (Intel, Apple silicon) and Windows (x86_64).
Elsewhere pip builds from the sdist, which needs Rust 1.88 or later; the install guide covers it and building from a checkout.
Formats
championsvgc and championsbss (Pokémon Champions VGC and Battle Spot
Singles), gen9vgc (Scarlet/Violet VGC), gen9ou (Smogon's Gen 9
OverUsed), gen9randombattle and gen9randomdoublesbattle (Showdown's
random battles, with its random-battle team generator), and the Gen 9 custom games
gen9singles and gen9doubles. See
FORMATS.
Quick start
One battle, turn by turn:
import pikapro
team = pikapro.sample_team("championsvgc") # Showdown export text
battle = pikapro.Battle("championsvgc", [team, team], seed=1)
while not battle.over:
for side in (0, 1):
legal = battle.legal_actions(side)
if legal:
battle.submit(side, legal[0]) # or a Showdown choice: "move 1 2, switch 3"
print(battle.winner, "\n".join(battle.log("p1")[-5:])) # player 1's Showdown log
The environment:
import numpy as np
import pikapro.rl as rl
env = rl.VecEnv("championsvgc", n=1024, opponent="simple_heuristics", seed=0)
out = env.reset(seed=0)
rng = np.random.default_rng(0)
for _ in range(100):
actions = env.sample_actions(rng, players=[0])[:, 0] # your policy here
out = env.step(actions)
# out.obs, out.masks, out.reward, out.terminated, out.truncated, out.winner
On a local server (pip install 'pikapro[showdown]'):
python -m pikapro.showdown ladder --format gen9championsvgc2026regmc \
--team team.txt --policy simple_heuristics --games 3
VGC Arena pairs the bots itself, so there the command
is accept, with ARENA_BOT_NAME and ARENA_BOT_TOKEN set:
python -m pikapro.showdown accept --server arena --team team.txt
Documentation
- Documentation home
- Quickstart
- Concepts
- Playing on a server
- Performance
- API reference
- Changelog
- The project
License
MIT.
Game data and mechanics come from
Pokémon Showdown (MIT),
and the built-in baseline opponents are ported from poke-env
(MIT). Their notices, and the licenses of the Rust crates compiled into
the extension module, are in THIRD_PARTY_NOTICES.
Pokémon and all related names are trademarks of Nintendo, Creatures Inc.,
Game Freak and The Pokémon Company. pikapro is not affiliated with or endorsed by
them, or by Pokémon Showdown.
Metadata
Release files for pikapro 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| pikapro-0.1.0.tar.gz | 2.6 MB | With provenance | Details for pikapro-0.1.0.tar.gz |
Built distributions (wheels)
Total release size: 21.1 MB
Release files / pikapro-0.1.0.tar.gz
| Download URL | pikapro-0.1.0.tar.gz |
|---|---|
| Size | 2.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a1d4be6eec408e8ec1d8540a85178d8efddd0a207865278f5c5d3c119e1722c0
|
|
BLAKE2b-256 checksum How to use checksums |
16493148b5738a33d7538008b3cacf1b2787b5c455a184dfad562e1ebbdddad2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.
Transparency logRelease files / pikapro-0.1.0-cp310-abi3-win_amd64.whl
| Download URL | pikapro-0.1.0-cp310-abi3-win_amd64.whl |
|---|---|
| Size | 2.7 MB |
| Tags | CPython 3.10 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
4c0145e92eed17250e30ad3607324688004b7ac422ef9752b6b4c2197487afdd
|
|
BLAKE2b-256 checksum How to use checksums |
0bd205d0340cf1e74827c8dfa6dc4ff5f4b2b8e7a79f4b83f3e8dc109bf1e217
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.
Transparency logRelease files / pikapro-0.1.0-cp310-abi3-musllinux_1_2_x86_64.whl
| Download URL | pikapro-0.1.0-cp310-abi3-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 2.8 MB |
| Tags | CPython 3.10 Linux musl 1.2+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
637ae4260edbb201455e71779660838a90dc345cb7dab5c85e6e578deb9f8a33
|
|
BLAKE2b-256 checksum How to use checksums |
d6fb344a967f8b3725de2598868e1c09bf43484ba7f9bd782091e7b7a2db479f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.
Transparency logRelease files / pikapro-0.1.0-cp310-abi3-musllinux_1_2_aarch64.whl
| Download URL | pikapro-0.1.0-cp310-abi3-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 2.7 MB |
| Tags | CPython 3.10 Linux musl 1.2+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
46f4f31aac96de7a401a735edb586f9f97ecea0cb02182a3257b0d6a329c13fb
|
|
BLAKE2b-256 checksum How to use checksums |
dacb769f643997322c7a8ce11a305dfa6b8ce7dd0bfc651800d869092d6e1d27
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.
Transparency logRelease files / pikapro-0.1.0-cp310-abi3-manylinux_2_28_x86_64.whl
| Download URL | pikapro-0.1.0-cp310-abi3-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.10 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
9d75bf883f43a11071a883cc4961507b84466bcb25c084dad70d2e655af4fa44
|
|
BLAKE2b-256 checksum How to use checksums |
801a609e91d751e293ed99b6b957c51ce1feb49e0bda5eb908b8d241369999a9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.
Transparency logRelease files / pikapro-0.1.0-cp310-abi3-manylinux_2_28_aarch64.whl
| Download URL | pikapro-0.1.0-cp310-abi3-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.10 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
9839d424d3b95e886b0b193ef680a9fa814c79be10dc0ed9753e727766c9bfcb
|
|
BLAKE2b-256 checksum How to use checksums |
7dbbea756cc6a09176f8117e3f96ed7517cfd0d3cd67edc180057ae21a6b21c2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.
Transparency logRelease files / pikapro-0.1.0-cp310-abi3-macosx_11_0_arm64.whl
| Download URL | pikapro-0.1.0-cp310-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 2.5 MB |
| Tags | CPython 3.10 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
5f7517573261511d2d7b3a025df86610e663e0c0484d9c08df5f27936cf74c55
|
|
BLAKE2b-256 checksum How to use checksums |
e8b9b8d928d35abe26dc11e2de637f974dc29d05316d05424f0bd30bdfddcf69
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.
Transparency logRelease files / pikapro-0.1.0-cp310-abi3-macosx_10_13_x86_64.whl
| Download URL | pikapro-0.1.0-cp310-abi3-macosx_10_13_x86_64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.10 abi3 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
5854293fbc3153b363b61c311a1551eafabe24514a74eb3210e5c493d59f27cd
|
|
BLAKE2b-256 checksum How to use checksums |
c068ce68783edbcfd6a4f58246da0f95aaa8cca02b0ea1e0778dd32440965194
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.
Transparency logSecurity for pikapro 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 8 files in this release have been uploaded with provenance metadata.
Attestation for pikapro-0.1.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.