🤖 Wordle Bot

Python project to play Wordle for me because I'm lazy

Table of Contents

• Quickstart
• Progress Overview
• Prerequisites
• Setup
• Usage

Quickstart

Already have Python and uv installed? Run via:

git clone https://github.com/davidsrrose/wordle-bot.git
cd wordle-bot
uv sync
uv run playwright install
uv run python -m play_wordle

Progress Overview

• Play Wordle with Playwright
• Send results to phone, whatsapp? slack?
• Automate w/ github actions to play & send daily
• Add tailored message/taunting
• Add AI agent to read and respond back to any texts?
• Improve Wordle algorithm/logic

Prerequisites

You will need the following (install if you do not have them):

Tool	Purpose	Install
🛠️ Git	Clone the repository	https://git-scm.com/downloads or brew install git (macOS)
🐍 Python (>=3.13, see uv.lock)	Runtime for the bot	https://www.python.org/downloads/ or use pyenv
🪄 uv	Manage virtual env and dependencies	`curl -Ls https://astral.sh/uv/install.sh

Setup

Follow these steps to set up the environment using uv.

1. Clone the repository

git clone https://github.com/davidsrrose/wordle-bot.git
cd wordle-bot

2. Install dependencies

uv sync
uv run playwright install

If you're developing, install git hooks so lint/format run before commits:

uv run pre-commit install

Usage

3. Run the program and watch it play Wordle 🎮

uv run python -m play_wordle

You can also run the top-level script if you prefer:

uv run python src/main.py