A WebTiles chat bot for DCSS IRC queries
Clone or download
gammafunk Increase the max request time for bot requests to 120 seconds
This was previously 100 seconds, but in some rare instances Sequell
timeout messages can take over that amount of time. We'd prefer to
recieve these and relay to users instead not returning anything, so
increase the timeout by 20%.
Latest commit 2dd90b9 May 6, 2018



beem is a multi-user chat bot that can relay queries to the IRC knowledge bots for DCSS from WebTiles chat. See the command guide for details on using beem from WebTiles chat. The remaining instructions on this page are only relevant if you want to run a custom instance of this bot.


beem supports monitoring the chat of any number of concurrent WebTiles games based on user subscriptions made in chat. It can also dedicate a connection to watching the most-spectated game on the server automatically. It manages a single Freenode IRC connection that relays queries to the knowledge bots, receives the results, and forwards them to the game chat that originated the query. The beem server is single-threaded and uses asyncio to manage an an event loop with concurrent tasks.


The following are required:

  • Python 3.4 or later
  • asyncio module (3.4.3 tested)
  • irc module (13.1 tested)
  • pytoml module (0.1.5 tested)
  • websockets module (3.0 tested)
  • webtiles module

All packages above except webtiles are available in PyPI. You can install the webtiles and beem packages directly from their respective repositories with pip3. For example:

pip3 install --user git+https://github.com/gammafunk/webtiles.git
pip3 install --user git+https://github.com/gammafunk/beem.git


Copy the beem_config.toml.sample file to beem_config.toml and edit the necessary fields based on how you'd like to run the bot. The config file format is toml, and the various fields you can change are in this file are documented in comments.