Wordle Solver
A hard-mode Wordle solving assistant. It narrows the candidate word list as you enter each guess and its result, and suggests the best next guesses using a letter-frequency heuristic. Includes a wager tracker for games played with per-letter betting rules.
Install
With pipx (recommended)
pipx installs the wordle command globally in an isolated environment — no virtual environment to manage.
pipx install .
To pick up code changes after editing the source:
pipx reinstall wordle-solver
With pip (development)
Requires Python 3.9+.
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
This installs the wordle command into the virtual environment's bin/.
Options
wordle [--top N] [--position-weight F] [--presence-weight F]
| Flag | Default | Description |
|---|---|---|
--top N |
10 | Number of suggestions to show after each guess |
--position-weight F |
1.0 | Weight on per-position letter frequency in the heuristic |
--presence-weight F |
1.0 | Weight on overall letter presence frequency in the heuristic |
Usage
Assisted mode (playing on an external Wordle board)
After each guess you make on the Wordle site, enter the word and its color result as a single string of letter–digit pairs:
> c2r1a0n0e0
Each digit encodes the tile color:
| Digit | Meaning |
|---|---|
2 |
Correct letter, correct spot (green / orange in colorblind mode) |
1 |
Correct letter, wrong spot (yellow / blue in colorblind mode) |
0 |
Letter not in the word (grey / black) |
The solver prints how many candidates remain, lists them when 20 or fewer are left, and shows the top-ranked hard-mode-valid suggestions.
Practice mode
/practice picks a secret word and lets you play through a full game. Type your guess as a plain word — no digits needed, the solver scores it for you. Hard mode is enforced: green letters must stay in their position, and all revealed letters must appear in every subsequent guess.
Commands
| Command | Description |
|---|---|
help |
Print the help text |
reset |
Clear the solver state for a new puzzle (keeps wager session total) |
quit |
Exit |
/practice |
Start a practice game: solver picks a secret word, scores your guesses |
/round |
Start a new wager round: clears solver state and the round total, exits practice mode |
/price |
Reset per-letter wager prices to the defaults ($1 correct / $2 present / $3 absent) |
/price <g> <y> <b> |
Set custom per-letter prices, e.g. /price 2 3 5 |
/addword <word> |
Add a missing word to the answers list, removing it from the guesses-only list if it was there |
Wager tracking
The solver tracks a running dollar cost for each guess based on its tile results. Default prices:
- Correct (green): $1
- Present (yellow): $2
- Absent (grey): $3
After each guess the solver prints the cost of that guess, the round total, and the session total. Use /price to match whatever betting rules your game uses.