Foundation system for creating chat bots for racetime.gg

pip install racetime-bot==1.8.0



Discord Twitter Follow

A Python library to help you create chat bots for racetime.gg.

What is this for?

The racetime application allows categories to set up their own bots, which can interact with ongoing races in order to supply information and similar actions.

This library provides a basic template for creating these bots.

Setup guide


  • Python 3.7 or greater.


Install via pip/PyPI:

pip install racetime-bot

How to get started

You should read the racetime-app documentation on Category bots to understand what you need to get started. You don't need a thorough understanding of the technical side of things to build your own bot, but it is helpful to be able to understand how messages are structured, and how they are used.

For an example of this library in use, you can look at the implementation of ootr-randobot. This should give you a decent insight into how you need to structure your bot. Feel free to re-use the code given in that repository in order to generate a bot yourself!


If you have something you wish to contribute, feel free to submit a pull request on this repo. You can also talk on our #dev Discord channel following the link at the top of this page.

If you wish to report an issue, please open a ticket on the main site repo here: https://github.com/racetimeGG/racetime-app/issues/new