comprobot 3.0.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/tap
brew install comprobot

Winget (Windows)

winget install badluma.comprobot

Scoop (Windows)

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

Docker (All platforms)

Set up credentials first:

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

Then start the bot:

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

Documentation

You can find the whole documentation here.

License

MIT