bands is an internet relay chat bot.

• covers all relevant portions of rfc's 1459 and 2812.
• ircv3 caps supported are chghost and multi-prefix.
• concurrent multi-server and multi-channel support.
• awareness of the channel, channel user, server and server user contexts.
• full state maniuplation and hot config reload through private messages on trusted servers.

and many more

# clone the repo
git clone --depth=1 https://github.com/gottaeat/bands
cd bands/

# create a configuration yaml following the specification and example below and
# put it in a path within this repo so that docker can reach it, e.g.
# $REPO_ROOT/files/config.yml

# spin up a container
docker compose run --rm --build=true bands \
    /bin/sh -c "\
        pip install --user --break-system-packages . && \
        bands -c ./files/config.yml"

wolfram_api_key: "XXXXX-XXXXXXXXXX"
openai_key: "sk-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
quote_file: ./files/quotes.json
doot_file: ./files/doots.json

servers:
  - name: privnet
    address: irc.cooldomain.to
    port: 6697
    passwd: topsekrit
    botname: bands
    tls: true
    channels:
      - "#mychannel"
      - "#mychannel2"
    allow_admin: true
    secret: EsDf/ZcdNp1whuZh
  - name: publicnet
    address: irc.example.com
    port: 6697
    botname: stacks
    tls: true
    verify_tls: true
    scroll_speed: 1
    channels:
      - "#pubchannel"

for user-accesible features, call ?help in either the context of a channel or a private message with the bot.

cmdline specific usage is:

usage: bands [-h] -c C [-d]

bands the IRC bot.

options:
  -h, --help  show this help message and exit
  -c C        Configuration YAML file.
  -d          Enable debugging.

1. set at least one of the servers to have allow_admin and a secret.
2. privmsg the botname with ?auth $secret.
3. call ?rcon help for a list of management related functionality.