Grace is the official Code Society discord bot. The goal is to give our members the opportunity to participate in the development of the server's bot and contribute to a team project while also improving it.
Installing Grace is fairly simple. You can do it in three short step.
Install Python. Python 3.10 or higher is required.
Note
We highly recommend that you set up a virtual environment to work on Grace. https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/
In the grace directory, open a terminal (Linus/MacOS) or cmd (Windows) and execute pip install -e .
(recommended for development) or pip install ..
If you did not already do it, create your Discord
bot. Then, create a file called .env in the project directory, open it and add
DISCORD_TOKEN=<Your token>. (Replace by your discord token).
Caution
Do not share that file nor the information inside with anyone.
The last part is to execute the bot. Execute grace run to run Grace in development mode. The rest
of the installation should complete itself and start the bot.
Note
If the grace command is unrecognized, be sure that you installed the bot properly.
- Bot Command(s):
grace run: Starts the bot (ctrl+cto stop)
- Database Command(s):
grace db create: Creates the databasegrace db drop: Deletes the databasegrace db up: Upgrade to latest migrationgrace db down: Downgrade to previous migrationgrace db seed: Seeds the tables
For advance configurations, visit the wiki
As mentioned in the description, we invite everyone to participate in the development of the bot. You can contribute to the project by simply opening an issue, by improving some current features or even by adding your own features. Before contributing please refer to our contribution guidelines and Code of Conduct for contributor (temporary unavailable).
If you're getting unexpected result, visit the wiki's troubleshooting page. For any other problems or questions ask us on our discord server.