Skip to main content

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.Battle and pikapro.BattlePool are the simulator.
  • pikapro.rl is the environment: n battles per call, each player seeing only what a Showdown client knows. It has adapters for Gymnasium, PettingZoo and Stable-Baselines3.
  • pikapro.showdown plays a policy trained in pikapro.rl on a local Showdown-protocol server or VGC Arena.
  • pikapro.compat.poke_env runs unmodified poke-env players on pikapro battles, 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

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)

Source distribution for pikapro 0.1.0
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)

Table of built distributions (wheels) for pikapro 0.1.0
File Actions
pikapro-0.1.0-cp310-abi3-win_amd64.whl CPython 3.10 abi3 Windows x86-64 Details for pikapro-0.1.0-cp310-abi3-win_amd64.whl
pikapro-0.1.0-cp310-abi3-musllinux_1_2_x86_64.whl CPython 3.10 abi3 Linux musl 1.2+ x86-64 Details for pikapro-0.1.0-cp310-abi3-musllinux_1_2_x86_64.whl
pikapro-0.1.0-cp310-abi3-musllinux_1_2_aarch64.whl CPython 3.10 abi3 Linux musl 1.2+ ARM64 Details for pikapro-0.1.0-cp310-abi3-musllinux_1_2_aarch64.whl
pikapro-0.1.0-cp310-abi3-manylinux_2_28_x86_64.whl CPython 3.10 abi3 Linux glibc 2.28+ x86-64 Details for pikapro-0.1.0-cp310-abi3-manylinux_2_28_x86_64.whl
pikapro-0.1.0-cp310-abi3-manylinux_2_28_aarch64.whl CPython 3.10 abi3 Linux glibc 2.28+ ARM64 Details for pikapro-0.1.0-cp310-abi3-manylinux_2_28_aarch64.whl
pikapro-0.1.0-cp310-abi3-macosx_11_0_arm64.whl CPython 3.10 abi3 macOS 11.0+ ARM64 Details for pikapro-0.1.0-cp310-abi3-macosx_11_0_arm64.whl
pikapro-0.1.0-cp310-abi3-macosx_10_13_x86_64.whl CPython 3.10 abi3 macOS 10.13+ x86-64 Details for pikapro-0.1.0-cp310-abi3-macosx_10_13_x86_64.whl

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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Security 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.

Select from 8 files

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 log

A 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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

8 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page