A Discord server bot developed for Nintendo Homebrew on Discord. Maintained primarily by NH staff and helpers.
Although it is open source, this bot is not really designed to be used in other setups at the moment; the source is mainly just available for those interested in how it works on the Nintendo Homebrew server.
A server template is available for testing Kurisu, with all the channels and roles necessary.
To test changes to Kurisu locally using Docker, make sure Docker Desktop (Windows and macOS) or Docker Engine (Linux) is installed.
For Linux, docker-compose must be installed separately.
Create a new application on Discord and add a bot. Put the token in token.txt in the same directory. (Newline at the end of the file doesn't matter.)
Start Kurisu with the following command. Assuming a clean setup, this will pull postgres:13 to run as the database, and python:3.9-alpine as the base image for Kurisu, then build a new Kurisu image. Then it will start up postgres first, then kurisu once the database is active.
docker-compose up --build
postgres database files are stored in a Docker volume called kurisutestdb. Use Ctrl-C if not running in detached mode to stop the bot.
-
docker-compose build- Build only, pull base images if required -
docker-compose build --pull- Build only, always try to pull base images for newer versions -
docker-compose pull- Pull images, in this case update postgres:13 -
docker-compose up -d- Detach and run containers in the background -
docker-compose down- Stop running containers and remove them
- Ever since the move to Docker and PostgreSQL this has not been as well tested, so tell us if something is wrong or confusing!
Set up PostgreSQL 13 or later (older versions aren't tested but might work).
Python 3.8 or later is required.
Install the dependencies in requirements.txt, ideally in a virtual environment.
Create a new application on Discord and add a bot.
Inside data/, create config.ini with the contents:
[Main]
token = <token for Discord bot>
database_url = <url of the database>database_url should follow a format like postgresql://user:password@ipaddr/database (example: postgresql://kurisu:dev123@127.0.0.1/kurisu).
Run the bot:
python3 kurisu.py