Comprobot is a highly customizable, open-source Discord bot that you can run on your own computer or server.
It’s built with Python and comes with a wide range of fun and useful commands. You can add new commands, customize response formats, or change the behavior of existing ones without touching the core code — all through simple TOML config files.
It also has built-in AI chat support, activated when you @mention the bot. Supported providers are Ollama, Groq, and Gemini.
Comprobot also comes with a web dashboard for managing your configuration from the browser.
Installation
Install Comprobot with pipx:
pipx install comprobotIf you don’t have Python or pipx yet, check out the full Installation guide. It also covers creating a Discord bot application and adding it to your server.
In short: install via pipx, create a bot on the Discord Developer Portal, add it to your server, copy the token into the .env file in the data directory (shown when you first run comprobot start), then run comprobot start again.
Contributing
Pull requests are always welcome on the Comprobot GitHub repo. If you have a suggestion but aren’t a coder, feel free to drop it in the suggestions channel on my Discord server.
Available commands
- General
- Money
- Settings
- Moderation
CLI
Comprobot has several CLI subcommands: start, dashboard, onboard, config, test, and reset. See the CLI reference for details.