Wordle Arena

Small Flask webapp to run a weekly Wordle contest.

Features

• Sunday–Saturday weekly contest
• Two servers: nyt and darthnice
• Participants paste emoji or header results and choose a participant ID
• Scores: guesses (1–6); failure or missing = 7
• Lowest weekly total wins
• Participant ID stored in a persistent cookie

Quick start

1. Create a virtualenv and install deps:

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. Run the app:

python app.py

3. Open http://localhost:5000

Notes

• Database file wordle_arena.db will be created in the repo root on first run.
• Cookie participant_id is set for 10 years to avoid re-entering the ID.

Wasmer / ASGI deployment

If you're deploying to an ASGI host such as Wasmer that expects an app symbol in a top-level module, this repo provides a:app which adapts the Flask WSGI application to ASGI. Before deploying, ensure dependencies are installed and run the environment check from the host to surface import/runtime errors:

python scripts/env_check.py

To run locally with an ASGI server (uvicorn):

# install uvicorn in your venv
pip install uvicorn
uvicorn a:app --host 0.0.0.0 --port 8080

If the module a fails to initialize in the runtime, a is defensive and will return an HTTP 500 with the initialization traceback so the deployment logs and the browser show a helpful message.

wordle_arena

a change