will
e5017efde8
Some real Wordle answers aren't in the bundled answers.txt list. This adds a REPL command to append a word to answers.txt and remove it from guesses.txt if present there, since the two lists are meant to be disjoint. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
91 lines
3.0 KiB
Markdown
91 lines
3.0 KiB
Markdown
# 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](https://pipx.pypa.io) installs the `wordle` command globally in an isolated environment — no virtual environment to manage.
|
||
|
||
```bash
|
||
pipx install .
|
||
```
|
||
|
||
To pick up code changes after editing the source:
|
||
|
||
```bash
|
||
pipx reinstall wordle-solver
|
||
```
|
||
|
||
### With pip (development)
|
||
|
||
Requires Python 3.9+.
|
||
|
||
```bash
|
||
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.
|