Skip to content
A chat bot loaded with commands designed for use in Discord servers.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE Initial Commit. :suspect: Dec 21, 2015 Update to use oauth2 tokens. Will make wiki page later. Apr 10, 2016


If you don't want to install CB yourself, you can ask the existing one to join your server. This way you get automatic updates and instant access to it's creator and what have you. Just join here:

Please read the terms of service before adding CacoBot to your server.


Install Python 3.

Install the Async branch of

For YouTube functionality, install the YouTube API Python Library.


Download the latest version of CacoBot and place it in a folder by itself.


Create a folder called configs with these two files, filling in any necessary information:


    "token" : "Place your application token here.",
    "client_id" : "Place your application client ID here.",
    "owner_id" : "Place your Discord ID here. Use .myid to get it with the bot.",
    "invoker" : "Place the character or line you want to invoke CB commands. Base CacoBot's is '.'",
    "log_request_limit" : 50,
    "games" : [
        "The Ultimate DOOM",
        "DOOM II: Hell On Earth"
    "error_messages": [
        "Oh no!",
        "How'd you do that?",
    "youtube" : {
        "DEVELOPER_KEY" : "Put your YouTube developer key here. Change the request limits if you feel like it. ['youtube']['request_limit'] is the max amount of videos that can be recieved. ['log_request_limit'] is the max amount of messages .log can retrieve.",
        "API_SERVICE_NAME" : "youtube",
        "API_VERSION" : "v3",
        "request_limit" : 5
    "pastebin_key" : "Get a Pastebin key from and put it here. We use it to post the tag list to Pastebin.",
    "git": {
        "repo_author" : "Orangestar12",
        "repo_name" : "cacobot",
        "comment" : "Replace these with your GitHub username and forked CacoBot repo name, or leave them to pull latest changes and source from the default."


  "orangestars-tag": {
      "tag": "This tag belongs to Orangestar in the CacoServer server!",
      "server": "128043020418285568",
      "owner": "88401933936640000"
  "nobodys-tag": {
      "tag": "This is an orphaned tag, and anyone can claim it!",
      "server": "None",
      "owner": "None"


Run in Python 3.

Congratulations, you have a CacoBot.

You can’t perform that action at this time.