bzimmer / qordle

Simple wordle solver
MIT License
0 stars 0 forks source link
wordle wordle-helper wordle-solver

qordle

build codecov Go Report Card

Simple wordle solution suggester

Install

$ brew tap bzimmer/tap
$ brew install qordle

Usage

qordle uses the hits, misses, and a pattern (if known) to suggest words matching the solution. See the complete manual for more features and documentation.

Input

Example

Screenshot

$ qordle suggest -s position -w solutions b.rAin stARt peARl
["chard","award","guard","charm","hoard","wharf","dwarf","quark","ovary"]
$ qordle play --start brain table | jq
{
  "secret": "table",
  "strategy": "frequency",
  "dictionary": 12947,
  "rounds": [
    {
      "dictionary": 118,
      "scores": [
        "~br~ain"
      ],
      "words": [
        "brain"
      ],
      "success": false
    },
    {
      "dictionary": 5,
      "scores": [
        "~br~ain",
        "mAB~es"
      ],
      "words": [
        "brain",
        "mabes"
      ],
      "success": false
    },
    {
      "dictionary": 4,
      "scores": [
        "~br~ain",
        "mAB~es",
        "cABLE"
      ],
      "words": [
        "brain",
        "mabes",
        "cable"
      ],
      "success": false
    },
    {
      "dictionary": 3,
      "scores": [
        "~br~ain",
        "mAB~es",
        "cABLE",
        "fABLE"
      ],
      "words": [
        "brain",
        "mabes",
        "cable",
        "fable"
      ],
      "success": false
    },
    {
      "dictionary": 2,
      "scores": [
        "~br~ain",
        "mAB~es",
        "cABLE",
        "fABLE",
        "gABLE"
      ],
      "words": [
        "brain",
        "mabes",
        "cable",
        "fable",
        "gable"
      ],
      "success": false
    },
    {
      "dictionary": 1,
      "scores": [
        "~br~ain",
        "mAB~es",
        "cABLE",
        "fABLE",
        "gABLE",
        "hABLE"
      ],
      "words": [
        "brain",
        "mabes",
        "cable",
        "fable",
        "gable",
        "hable"
      ],
      "success": false
    },
    {
      "dictionary": 1,
      "scores": [
        "~br~ain",
        "mAB~es",
        "cABLE",
        "fABLE",
        "gABLE",
        "hABLE",
        "TABLE"
      ],
      "words": [
        "brain",
        "mabes",
        "cable",
        "fable",
        "gable",
        "hable",
        "table"
      ],
      "success": true
    }
  ],
  "elapsed": 2
}

Strategies

qordle supports a number of different strategies and those strategies can be chain to build new strategies.

Performance of different strategy compositions for 2000 randomly sampled words

strategy winners total pct
speculate{chain{frequency,position}} 1930 2000 96.5
speculate{chain{frequency,position,bigram}} 1915 2000 95.8
speculate{chain{frequency,elimination}} 1911 2000 95.5
speculate{chain{frequency,bigram}} 1877 2000 93.8
speculate{frequency} 1875 2000 93.8
speculate{elimination} 1868 2000 93.4
speculate{position} 1858 2000 92.9
speculate{bigram} 1663 2000 83.2