comprobot 2.3.0

A self-hostable Discord bot built for maximum customization.

Comprobot

Comprobot is a highly-customizable, open-source Discord bot that you can run on your own server.

It’s built with Python, has a wide range of fun and useful commands, and is designed to be easy to extend. You can add new commands, customize outputs, or change the behaviour of existing ones. You can also easily edit the keywords of existing commands and customize their outputs.

The bot also comes with built-in AI capabilities when pinging the bot, with Ollama, Groq and Gemini as available providers.

Install

pipx (All platforms)

pipx install comprobot

APT (Ubuntu/Debian/Kali)

# If add-apt-repository isn't found, run this first:
# sudo apt install software-properties-common
sudo add-apt-repository ppa:badluma/ppa
sudo apt update
sudo apt install comprobot

AUR (Arch)

yay -S --noconfirm --nodiffmenu comprobot

Homebrew (macOS)

brew tap badluma/homebrew
brew install comprobot

Scoop (Windows)

scoop bucket add badluma https://github.com/badluma/scoop-bucket
scoop install comprobot

Docker

docker run -d \
  -v comprobot-data:/root/.local/share/Comprobot \
  --name comprobot \
  badluma/comprobot:latest

First run, set up credentials:

docker run -it --rm \
  -v comprobot-data:/root/.local/share/Comprobot \
  badluma/comprobot:latest onboard

Documentation

You can find the whole documentation here.

License

MIT