botbowl is a pip-installable python package. We recommend installing with Anaconda but it is not a requirement.

Python version

botbowl currently works with python 3.6 - 3.9
Verify your python version with

python --version

If you just installed Anaconda, create and activate a new environment.

conda create --name botbowl python=3.7
conda activate botbowl

Installation with pip

pip install git+

Or, use pip3 if your pip points to a python 2 installation.

Installation with git

Alternatively, if you want to run our examples or develop on botbowl, you can clone the repository and install it locally.

git clone
cd botbowl
python build
pip install -e .

To test the installation, run the following:

python -c "import botbowl"

This should not produce an import error.

If you cloned the repository and installed locally, you can start the web server:

python examples/ 

and then go the to play a game.

If you ran into issues, please seek help at our Discord server.

Compiling with Cython

Cython is a language that makes writing C extensions for Python as easy as Python itself.”

Some of the botbowl modules are prepared for compilation with Cython. Compiling them will make the framework run faster. You need to have a C++ compiler available. Check the Cython documentation for more information.

Installation through pip will automatically build with Cython if possible. If you cloned the repository with git, you need to manually call the build script by standing in the root of the repo and running:

python build 

You get a message confirming that botbowl was built with Cython. To test simply try to import one of the compiled modules with import botbowl.core.pathfinding.cython_pathfinding. You’re good to go!