Bot Wordle
Automatically fetch and solve the daily NYT Wordle puzzle, producing a shareable emoji grid. The solver achieves ~99.8% win rate with an average of ~3.6 turns.
Installation
pip install git+https://github.com/fkodom/wordle.git
Requires Python 3.7+. Installs colorama and gdown as dependencies.
Usage
Solve today's Wordle
bot-wordle
Solve a specific date
bot-wordle --date 2024-06-15
Use win-percentage optimization (starts with RALPH instead of SLATE)
bot-wordle --mode win-percentage
Arguments
Argument Default Description
--date
today Puzzle date in YYYY-MM-DD format
--mode
turns-to-win
turns-to-win (fewest guesses) or win-percentage (highest win rate)
Output
A shareable Wordle emoji grid printed to stdout:
Wordle 1234 3/6
🟩🟨⬛⬛⬛ 🟩🟩⬛🟨🟨 🟩🟩🟩🟩🟩
How It Works
-
Fetches the puzzle solution from the public NYT API (nytimes.com/svc/wordle/v2/{date}.json )
-
Simulates a 6-guess game using WordleSolver with a hybrid strategy:
-
128 remaining words: Rank by letter probability
-
17-128 remaining words: Maximize information via split analysis
-
<=16 remaining words (win-percentage mode): Exhaustive search
-
Default starting word: SLATE (turns-to-win) or RALPH (win-percentage)
-
Formats the result as a standard shareable emoji grid
Other Available Commands
The same package also provides interactive play and solver-assisted modes:
Command Description
solve-wordle
Interactive solver that recommends guesses as you play
play-wordle
Play Wordle in the terminal
play-dordle / play-quordle / play-octordle
Multi-word variants
solve-dordle / solve-quordle / solve-octordle
Solver for multi-word variants