Astrocade is a Discord Bot that enhances the Discord Activities experience.

Features

• Wordle stat tracking, history, and leaderboards.

Getting Started

Quick Start: Docker (Recommended)

Important

Discord API credentials for a Bot user are required.

Edit and run this compose.yaml example with docker compose up -d.

services:
  astrocade:
    container_name: astrocade
    image: ethanchrisp/astrocade:latest
    environment:
      LOG_LEVEL: INFO
      LOG_DISCORD_WEBHOOK_URL: https://discord.com/api/webhooks/XXXXXXXX/XXXXXXXX
      LOG_DISCORD_WEBHOOK_LEVEL: WARNING
      DISCORD_BOT_TOKEN: XXXXXXXX
      DISCORD_SERVER_IDS: 0000000000
      TZ: America/Denver
    volumes:
      - /path/to/database.db:/astrocade/astrocade.db
    restart: unless-stopped

Standalone

Note

Astrocade targets Python 3.14 and newer. Compatibility with earlier versions is not guaranteed.

Install Python and the required dependencies with uv:

uv sync

Rename .env.example to .env and configure your environment.

Run Astrocade with uv.

uv run astrocade.py -OO

Configuration

All configuration is managed through environment variables on the system hosting the Bot instance.

Environment Variable	Description	Default
LOG_LEVEL	Loguru level of log events to print to the console.	INFO
LOG_DISCORD_WEBHOOK_URL	Discord Webhook URL to forward log events to.	N/A
LOG_DISCORD_WEBHOOK_LEVEL	Loguru level of log events to forward to Discord.	N/A
DATABASE_PATH	Path to where the SQLite Database is stored.	./astrocade.db
DISCORD_BOT_TOKEN (Required)	Discord API credentials for your Bot user.	N/A
DISCORD_SERVER_IDS (Required)	Comma-separated list of Discord server IDs to sync commands to.	N/A
WORDLE_BOT_ID	User ID of the Wordle Discord Activity Bot user.	1211781489931452447
WORDLE_CUTOFF_HOUR	Hour after midnight (local time) that determines the cutoff for treating messages as belonging to the previous day.	3
WORDLE_POINTS_ATTEMPTS_1	Number of points awarded for a Wordle puzzle completion in 1 attempt.	10
WORDLE_POINTS_ATTEMPTS_2	Number of points awarded for a Wordle puzzle completion in 2 attempts.	5
WORDLE_POINTS_ATTEMPTS_3	Number of points awarded for a Wordle puzzle completion in 3 attempts.	4
WORDLE_POINTS_ATTEMPTS_4	Number of points awarded for a Wordle puzzle completion in 4 attempts.	3
WORDLE_POINTS_ATTEMPTS_5	Number of points awarded for a Wordle puzzle completion in 5 attempts.	2
WORDLE_POINTS_ATTEMPTS_6	Number of points awarded for a Wordle puzzle completion in 6 attempts.	1
WORDLE_POINTS_FAIL	Number of points deducted for a failed Wordle puzzle completion.	-5
DICTIONARY_API_KEY	Free API Key for the Merriam-Webster Collegiate Dictionary.	N/A
TZ	IANA time zone key for the host machine time zone.	UTC

Disclaimer

Astrocade is not affiliated with or endorsed by Activision, Discord, or The New York Times.

All trademarks and assets belong to their respective owners.