Skip to content
Discord bot for mathematics
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
images Move thigns out of the docs folder Sep 5, 2017
mathbot f-tex-delete is now applied properly Jun 17, 2019
.gitattributes Move the main source in here! Sep 9, 2017
.gitignore Merge branch 'master' into improve-calc-lib Jan 26, 2019
LICENCE Move the main source in here! Sep 9, 2017
Pipfile Upgrade discord.py in the hopes of fixing an error Jan 2, 2019
Procfile Bump to 10 shards Dec 7, 2018
README.md
add.html github doesn't like pages without an extension Oct 6, 2018
index.html github doesn't like pages without an extension Oct 6, 2018
logo.svg Simple script to update the bot's profile picture Oct 21, 2017
runtime.txt Bump python version Feb 22, 2018
style.css Update the information on Patrons Mar 15, 2018

README.md

MathBot

MathBot is a discord bot that contains a number of features to help with mathematics.

It's primary features are:

  • LaTeX rendering
  • Querying Wolfram|Alpha
  • A Turing complete calculator

The bot is currently developed for python 3.6.4.

Links

Setup for use

git clone https://github.com/DXsmiley/mathbot.git
cd mathbot
cp mathbot/parameters_default.json mathbot/parameters.json
pipenv --python 3.6
pipenv install --skip-lock

Then open parameters.json and change tokens to the token of the bot used for development. Optionally change the other parameters.

It is strongly recommend that you setup an instance of Redis if you want to use the bot on even a moderate scale. The disk-based keystore is easy to setup but runs very slowly, and as such is only useful of a development tool.

Then navigate into the mathbot directory and run the bot with python entrypoint.py parameters.json.

Setup for development

git clone https://github.com/DXsmiley/mathbot.git
cd mathbot
cp mathbot/parameters_default.json mathbot/parameters.json
pipenv --python 3.6
pipenv install --dev --skip-lock

Then open parameters.json and change tokens to the token of the bot. Change release to development. Optionally change the other parameters.

Then navigate into the mathbot directory and run the bot with python entrypoint.py parameters.json.

Contributing guide

Relevent discussion takes place on the MathBot Discord server.

For small changes, feel free to fork the repo and make a pull request once you've made the changes. For larger things, check the Trello board and see if anyone's already working on it. If not, shoot me a message to say that you're working on it so we don't get multiple people doing the same thing.

Yes I use tabs for indentation.

Setting up Wolfram|Alpha

  1. Grab yourself an API key
  2. Open parameters.json and change wolfram > key.

This should really only be used for development and personal use.

Test Suite

Use the test script in side the mathbot folder to run the test suite.

Some of the tests require that a bot is running and connected to Discord. To enable them, use the --run-automata command line argument. In addition a file with the necessary tokens filled out needs to be provided to the --parameter-file argument. To get all tests running, the token, automata and wolfram parameters need to be filled out.

For the sake of example, I run my tests with the command ./test --run-automata --parameter-file=dev.json. You should replace dev.json with a path to your own parameter file.

There are some additional tests that require a human to verify the bot's output. These can be enabled with --run-automata-human.

Guide to parameters.json

  • release : Release mode for the bot, one of "development", "beta" or "production"
  • token : Token to use for running the bot
  • wolfram
    • key : API key for making Wolfram|Alpha queries
  • keystore
    • disk
      • filename : The file to write read and write data to when in disk mode
    • redis
      • url : url used to access the redis server
      • number : the number of the database, should be a non-negative integer
    • mode : Either "disk" or "redis", depending on which store you want to use. Disk mode is not recommended for deployment.
  • patrons : list of patrons
    • Each key should be a Discord user ID.
    • Each value should be a string starting with one one of "linear", "quadratic", "exponential" or "special". The string may contains additional information after this for human use, such as usernames or other notes.
  • analytics : Keys used to post information to various bot listings.
  • automata
    • token : token to use for the automata bot
    • target : the username of the bot that the automata should target
    • channel: the ID of the channel that the tests should be run in
  • advertising
    • enable : should be true or false. When true, the bot will occasionally mention the Patreon page when running queries.
    • interval : the number of queries between mentions of the Patreon page. This is measured on a per-channel basis.
    • starting-amount : Can be increased to lower the number of commands until the Patreon page is first mention.
  • error-reporting
    • channel: ID of channel to send error reports to. If not specified, reports will not be sent.
  • shards
    • total: The total number of shards that the bot is running on.
    • mine: A list of integers (starting at 0) specifying which shards should be run in this process.
You can’t perform that action at this time.