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 on python 3.8.10
, but should work on later versions of Python.
git clone https://github.com/DXsmiley/mathbot.git
cd mathbot
cp mathbot/parameters_default.json ./parameters.json
python3.8 -m venv .venv # or later version
source .venv/bin/activate
pip install -r requirements.txt
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.
Run the bot with python -m mathbot parameters.json
.
Follow above instructions, but additionally run pip install -r dev_requirements.txt
Relevent discussion takes place on the MathBot Discord server.
- Grab yourself an API key
- Open parameters.json and change
wolfram > key
.
This should really only be used for development and personal use.
Invoke pytest
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
.
- 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.
- disk
- 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.
- carbon: Details for carbonitex
- discord-bots: API Key for bots.discord.pw
- bots-org: API Key for discordbots.org
- 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
orfalse
. Whentrue
, 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.
- enable : should be
- error-reporting
- channel: ID of channel to send error reports to.
- webhook: Webhook to send error reports to.
- 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.
If you don't have python 3.8
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.8
If you have installation troubles with cffi or psutil
sudo apt-get install python3.8-dev