# 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.