Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
97 lines (64 sloc) 2.51 KB

Run your own bot

Run your own bot by following the instructions below.

Note that the cathy package requires Python 3.7+ and of version 1.2.5+. Python 3.7 introduced backwards incompatible changes with the package version being used so older versions may not work.


Install the Python package:

pip install cathy

Or download this package and install with

python install


Run on the command-line to get help:

cathy --help

You can also invoke it as a Python module directly:

python -m cathy --help


Usage information:

  cathy <channel> <token> <logfile> <database>

  <channel>     Name of Discord channel to chat in. E.g. "general"
  <token>       Bot's Discord API token
  <logfile>     Path for log file. E.g. "/opt/cathy/cathy.log"
  <database>    Path for database file. E.g. "/opt/cathy/cathy.db"
  -h --help     Show this screen.

Example usage:

# Enter the channel name with no # sign
cathy chat-with-cathy "XXSECRETTOKENXX" /opt/cathy/cathy.log /opt/cathy/cathy.db

Set up a Linux systemd service

Use the service file in systemd/cathy.service as a template. Set up cathy as normal, and then modify the systemd service file as needed and copy or symlink it to /etc/systemd/system/cathy.service and then you can manage the service with:

sudo systemctl enable|disable|start|stop|status|restart cathy

Running with Docker

The included Dockerfile will let you run the bot in a Docker container

Build the image first by running docker build from the root project directory:

docker build . --tag cathy

Then run it with:

docker run cathy

Getting a token

If you don't already know how to get a token, you need to follow a few steps:

  • Create an application at
  • In the application, go to Bot tab.
  • Click add bot user.
  • Go to OAuth2 tab, scroll down to Scopes section
  • Click on "bot" scope and copy the URL it provides
  • Visit the URL in your browser and accept the bot invitation to your server
  • Go back to the Bot tab
  • Copy the token from the Bot tab.

How can I create my own bot?

If you want to create your own bot, you can follow some of these tutorials on

You can’t perform that action at this time.