Wordle Bot

Discord bot that tracks daily Wordle scores from the Wordle app summary messages.

Setup

1. Create the Discord bot

1. Go to https://discord.com/developers/applications
2. Click New Application, name it "Wordle Bot"
3. Go to Bot → click Add Bot
4. Under Privileged Gateway Intents, enable:
   • Server Members Intent
   • Message Content Intent
5. Copy the token — you'll need it in step 3
6. Go to OAuth2 → URL Generator:
   • Scopes: bot, applications.commands
   • Bot Permissions: Read Messages/View Channels, Read Message History, Send Messages, Embed Links, Attach Files
7. Open the generated URL to invite the bot to your server

2. Enter the dev shell

nix develop

3. Configure environment

cp .env.example .env
# Edit .env and set DISCORD_TOKEN=your_token_here

4. Run the bot

python bot.py

On first run the bot will backfill all historical messages from both channels. This may take a few minutes.

Slash Commands

Command	Description
/leaderboard [period]	Score leaderboard (7d / 30d / all time)
/shame [period]	Most X/6 failures
/stats [@user]	Personal stats with streaks
/history [@user]	Last 15 results
/today	Most recent day's results
/versus @user1 @user2	Head-to-head comparison
/chart distribution [@user]	Score distribution bar chart
/chart timeline @user	Score over time
/chart weekly	Weekly average comparison

A weekly summary chart is automatically posted to #wordle every Monday at 9:00 AM UTC.

Deployment (VPS)

Run as a systemd service. Create /etc/systemd/system/wordle-bot.service:

[Unit]
Description=Wordle Discord Bot
After=network.target

[Service]
Type=simple
User=youruser
WorkingDirectory=/path/to/wordle-bot
EnvironmentFile=/path/to/wordle-bot/.env
ExecStart=nix develop --command python bot.py
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

Then:

sudo systemctl enable wordle-bot
sudo systemctl start wordle-bot
sudo journalctl -u wordle-bot -f