countable

A alphabet count bot inspired by Counting

How this works

You continue saying alphabet in order like this

a
b
... 
z

But when it reached ended sequel, you add a character to it like you counting a number like this

aa
ab
...
az
ba
bb
bc
...
bz

etc.
If you ruined the chain you will be logged and people can look at who ruined the chain.
This entire came from snaky's idea and inspired by counting bot

How to setup

There's 2 types you can host this bot.

Replit (likely the easiest)
Docker (easier than replit and can be scaled)
Others (applies to others that they don't show the files publicly)

Replit

Clone my repl is the easiest way but you can follow stuff below.
Clone my repository and tell replit to run the following command everytime repl starts up

python bot.py

You also likely need to install packages using poetry (I think it is install for it automatically)

poetry install

You need to also need to add env var via Secrets like:

ALPHABET_DB_HOST=<postgresql server hostname>
ALPHABET_DB_PORT=<postgresql server port>
ALPHABET_DB_USER=<postgresql server username>
ALPHABET_DB_PASSWORD=<postgresql server password>
ALPHABET_DB_NAME=<postgresql database name>
ALPHABET_URI=<postgresql uri if you don't want to type stuff up there>
ALPHABET_TOKEN=<bot token>
IS_REPLIT=any value (this is for replit)

Start repl up and you should be good to go(?)

Docker

Compose (Easiest)

Create new file called compose.yaml with these contents inside:

services:
    countable:
        image: ghcr.io/timelessnesses/countable
        environment:
            - ALPHABET_DB_HOST=db
            - ALPHABET_DB_PORT=5432
            - ALPHABET_DB_USER=countable
            - ALPHABET_DB_PASSWORD=countable
            - ALPHABET_DB_NAME=countables
            - ALPHABET_TOKEN=<TOKEN>
    db:
        image: postgres:14
        environment:
            - POSTGRES_USER=countable
            - POSTGRES_PASSWORD=countable
            - POSTGRES_DB=countables
        volumes:
            - data:/var/lib/postgresql/data
volumes:
    data:

Then start it up with docker compose up (add -d for running it in the background)

Running directly from an image

Clone the image with docker pull ghcr.io/timelessnesses/countable:latest and run it by

docker run ghcr.io/timelessnesses/countable -e ALPHABET_DB_HOST=<Database's hostname> -e ALPHABET_DB_PORT=<Database's server port> -e ALPHABET_DB_USER=<User account for accessing database's server> -e ALPHABET_DB_PASSWORD=<A password for user account> -e ALPHABET_DB_NAME=<Database name> -e ALPHABET_TOKEN=<Discord bot token>

Cloned from GitHub Repository (Compose)

Create .env with these contents inside:

ALPHABET_TOKEN=<TOKEN>

Then run make compose_run

Cloned from GitHub Repository (Image)

You need make for this to work.

Run make build_image then run

docker run countable_dev:latest -e ALPHABET_DB_HOST=<Database's hostname> -e ALPHABET_DB_PORT=<Database's server port> -e ALPHABET_DB_USER=<User account for accessing database's server> -e ALPHABET_DB_PASSWORD=<A password for user account> -e ALPHABET_DB_NAME=<Database name> -e ALPHABET_TOKEN=<Discord bot token>

Others

Rename .env.example to .env and add your env vars.

ALPHABET_DB_HOST=<postgresql server hostname>
ALPHABET_DB_PORT=<postgresql server port>
ALPHABET_DB_USER=<postgresql server username>
ALPHABET_DB_PASSWORD=<postgresql server password>
ALPHABET_DB_NAME=<postgresql database name>
ALPHABET_URI=<postgresql uri if you don't want to type stuff up there>
ALPHABET_TOKEN=<bot token>

and run python -m pip install poetry then python -m poetry install then python -m poetry shell and run python bot.py

Current State

Stable
Broken