# Wordle Solver
## A python package designed to solve the popular word-guessing game and many of its variants.
   
## Setup
You may download and install this package using pip
```bash
pip install wordle-autosolver
```
Google Chrome and ChromeDriver are also required to be installed on your device. There is a python package that will do this for you called [`chromedriver-autoinstaller`](https://pypi.org/project/chromedriver-autoinstaller/).
Otherwise, use [this link](https://chromedriver.chromium.org/getting-started) to go to the chromedriver page and follow the installation instructions.
Alternatively, if you do not wish to use the auto-solve feature, you may download [`wordle-autosolver-lite`](https://pypi.org/project/wordle-autosolver-lite/) for the version without selenium.
## Usage
Use this module to solve Wordle and other similar puzzles. Default behavior requires the user to interact with the program through the console. This program will use the user's guess and the game's response to filter a list of possible answers. It will then check every possible guess the user could make next, and check the size of the answer list after each possible response. The program will then recommend the guesses which have the smallest worst-case response. The "-auto" flag allows the user to automate the entry of guesses and responses by connecting to websites and interacting with them using chromedriver + selenium. Current supported websites include: [Wordle](www.nytimes.com/games/wordle/index.html), [Dordle](zaratustra.itch.io/dordle), [Quordle](www.quordle.com), [Octordle](octordle.com), [Sedecordle](www.sedecordle.com), [Duotrigordle](duotrigordle.com), [64ordle](64ordle.au), [Nordle](www.nordle.us), [Wordzy](wordzmania.com/Wordzy), and [Fibble](fibble.xyz).
```
python wordle_autosolver [-h] [--num N] [--nyt | --hard | --master | --liar] [--best] [--quiet]
[--play | --auto WEBSITE | --sim MAX_SIMS] [--start WORD [WORD ...]]
[--continue LIMIT | --endless | --challenge] [--light] [--clean]
optional arguments:
-h, --help show this help message and exit
--num N number of simultaneous games (default: 1)
--nyt only consider answers that are in the New York Times official word list
--hard use if playing on hard mode (default: False)
--master only set this flag if the game does not tell you which colors belong to
which letters (default: False)
--liar use if playing Fibble where one letter in each response is always a lie
(default: False) (currently does not support use with "auto" flag)
--best set this flag to generate a minimal guess tree (be aware that this process
may be very slow) once completed, the program will continue as normal using
this generated tree to recommend guesses
--quiet hide all unnecessary console output
--play set this flag to play a game of Wordle using the command line
--auto WEBSITE set this flag to automate play on the given website (requires chromedriver)
-- NOTE: websites with a fixed number of boards will override the N
argument for number of boards -- valid websites are: 'wordle', 'wordzy',
'dordle', 'quordle', 'octordle', 'sedecordle', 'duotrigordle', '64ordle',
'nordle', and 'fibble'
--sim MAX_SIMS set this flag to simulate MAX_SIMS unique games and give resulting stats
--start WORD [WORD ...]
set this flag if there are certain words you want to start with regardless
of the response
--continue LIMIT set this flag to continue playing on multiple boards up to the given number
(max 500) -- setting the limit to "-1" will test all possible starting
words to find the best one(s) (be aware that this process may be very slow)
--endless use to play the same game over and over -- when used with "-auto wordzy",
will play Wordzy's Maniac mode where the number of games increment by one
--challenge play the daily Wordle, Dordle, Quordle, and Octordle in order, using the
answers from each puzzle as the starting words for the next (inspired by
YouTube channel Scott Stro-solves)
--light set this flag to force all websites to switch to light mode (if available)
-- when "auto" is not set, this flag is ignored
--clean empty the contents of "data/best_guess.json", "data/responses.json", and
each of their variants to relieve some storage space (the program will not
execute any other commands when this flag is set)
```
## Example Console Output
```
$ python wordle_autosolver --auto wordle --num 4 --start lucky words
Loading precalculated data...
Finished loading.
Connecting to the target website...
Connected to 'https://www.quordle.com/#/'
Starting solver. Simulating 4 simultaneous Wordle games.
Suggested starting word is SALON
Solved 0/4 boards: [*****, *****, *****, *****]
Predetermined guess is LUCKY
Response was "....." on board 1
Best guess(es) on board 1: SANER
1576 possible answers
Response was "....." on board 2
Best guess(es) on board 2: SANER
1576 possible answers
Response was "..+.." on board 3
Best guess(es) on board 3: SHORE
309 possible answers
Response was ".O..." on board 4
Best guess(es) on board 4: TERMS, TREMS
149 possible answers
Solved 0/4 boards: [*****, *****, *****, *U***]
Predetermined guess is WORDS
Response was "+...+" on board 1
Best guess(es) on board 1: POINT, MEANT, PHASE, SHAPE, PRINT, SAINT, SPITE, PAINT, ...
18 possible answers
Response was ".O..+" on board 2
Best guess(es) on board 2: MEDIA, EMAIL, MERIT, FISTS, THINE, MAIZE, MISTY, AMINE, ...
18 possible answers
Response was "...O." on board 3
The answer on board 3 is CHIDE
Response was "....O" on board 4
Best guess(es) on board 4: PETIT, BATHE, INEPT, MOTEN, PATEN, PETTI, MEINT
34 possible answers
Solved 1/4 boards: [*****, *O***, CHIDE, *U**S]
Guessing CHIDE...
Response was "....+" on board 1
Best guess(es) on board 1: SWEEP
4 possible answers: SWEET, SWEPT, SWEAT, SWEEP
Response was "....O" on board 2
Best guess(es) on board 2: AMONG, ALONG, WRONG, SIGNS, GROWN, SONGS, MASON, AGONY, ...
4 possible answers: GOOSE, MOOSE, NOOSE, POSSE
Response was "....+" on board 4
Best guess(es) on board 4: THUMB, TOMBS, AMBIT, TIMBO
10 possible answers
Solved 1/4 boards: [SWE**, *O*SE, CHIDE, *U**S]
Guessing AMBIT...
Response was "....." on board 1
The answer on board 1 is SWEEP
Response was ".+..." on board 2
The answer on board 2 is MOOSE
Response was "....." on board 4
Best guess(es) on board 4: GUESS, FUSES
2 possible answers: GUESS, FUSES
Solved 3/4 boards: [SWEEP, MOOSE, CHIDE, *U**S]
Guessing SWEEP...
Response was "+.O.." on board 4
The answer on board 4 is GUESS
Solve complete.
Entering all remaining answers... (2 total)
Entered 1/4 SWEEP
Entering 2/4 MOOSE
Entered 3/4 CHIDE
Entering 4/4 GUESS
Saving all newly discovered data...
Save complete.
PRESS ENTER TO EXIT
```
Raw data
{
"_id": null,
"home_page": "https://github.com/pueblak/wordle-autosolver",
"name": "wordle-autosolver",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "",
"keywords": "wordle,solve,solver,optimize,optimal,best,website,automate,selenium,chromedriver,dordle,quordle,octordle,duotrigordle,fibble,wordzy",
"author": "Kody Puebla",
"author_email": "pueblakody@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/56/29/a42243a6c60b1406bd9c03410f65988f0766d987a7a20566167d02c8400f/wordle_autosolver-0.7.4.tar.gz",
"platform": null,
"description": "# Wordle Solver\r\n## A python package designed to solve the popular word-guessing game and many of its variants.\r\n\r\n   \r\n\r\n\r\n\r\n## Setup\r\nYou may download and install this package using pip\r\n```bash\r\npip install wordle-autosolver\r\n```\r\nGoogle Chrome and ChromeDriver are also required to be installed on your device. There is a python package that will do this for you called [`chromedriver-autoinstaller`](https://pypi.org/project/chromedriver-autoinstaller/).\r\n\r\nOtherwise, use [this link](https://chromedriver.chromium.org/getting-started) to go to the chromedriver page and follow the installation instructions.\r\n\r\nAlternatively, if you do not wish to use the auto-solve feature, you may download [`wordle-autosolver-lite`](https://pypi.org/project/wordle-autosolver-lite/) for the version without selenium.\r\n\r\n\r\n\r\n## Usage\r\nUse this module to solve Wordle and other similar puzzles. Default behavior requires the user to interact with the program through the console. This program will use the user's guess and the game's response to filter a list of possible answers. It will then check every possible guess the user could make next, and check the size of the answer list after each possible response. The program will then recommend the guesses which have the smallest worst-case response. The \"-auto\" flag allows the user to automate the entry of guesses and responses by connecting to websites and interacting with them using chromedriver + selenium. Current supported websites include: [Wordle](www.nytimes.com/games/wordle/index.html), [Dordle](zaratustra.itch.io/dordle), [Quordle](www.quordle.com), [Octordle](octordle.com), [Sedecordle](www.sedecordle.com), [Duotrigordle](duotrigordle.com), [64ordle](64ordle.au), [Nordle](www.nordle.us), [Wordzy](wordzmania.com/Wordzy), and [Fibble](fibble.xyz).\r\n```\r\npython wordle_autosolver [-h] [--num N] [--nyt | --hard | --master | --liar] [--best] [--quiet]\r\n [--play | --auto WEBSITE | --sim MAX_SIMS] [--start WORD [WORD ...]]\r\n [--continue LIMIT | --endless | --challenge] [--light] [--clean]\r\n\r\noptional arguments:\r\n -h, --help show this help message and exit\r\n --num N number of simultaneous games (default: 1)\r\n --nyt only consider answers that are in the New York Times official word list\r\n --hard use if playing on hard mode (default: False)\r\n --master only set this flag if the game does not tell you which colors belong to\r\n which letters (default: False)\r\n --liar use if playing Fibble where one letter in each response is always a lie\r\n (default: False) (currently does not support use with \"auto\" flag)\r\n --best set this flag to generate a minimal guess tree (be aware that this process\r\n may be very slow) once completed, the program will continue as normal using \r\n this generated tree to recommend guesses\r\n --quiet hide all unnecessary console output\r\n --play set this flag to play a game of Wordle using the command line\r\n --auto WEBSITE set this flag to automate play on the given website (requires chromedriver)\r\n -- NOTE: websites with a fixed number of boards will override the N\r\n argument for number of boards -- valid websites are: 'wordle', 'wordzy',\r\n 'dordle', 'quordle', 'octordle', 'sedecordle', 'duotrigordle', '64ordle',\r\n 'nordle', and 'fibble'\r\n --sim MAX_SIMS set this flag to simulate MAX_SIMS unique games and give resulting stats\r\n --start WORD [WORD ...]\r\n set this flag if there are certain words you want to start with regardless\r\n of the response\r\n --continue LIMIT set this flag to continue playing on multiple boards up to the given number\r\n (max 500) -- setting the limit to \"-1\" will test all possible starting\r\n words to find the best one(s) (be aware that this process may be very slow)\r\n --endless use to play the same game over and over -- when used with \"-auto wordzy\",\r\n will play Wordzy's Maniac mode where the number of games increment by one\r\n --challenge play the daily Wordle, Dordle, Quordle, and Octordle in order, using the\r\n answers from each puzzle as the starting words for the next (inspired by\r\n YouTube channel Scott Stro-solves)\r\n --light set this flag to force all websites to switch to light mode (if available)\r\n -- when \"auto\" is not set, this flag is ignored\r\n --clean empty the contents of \"data/best_guess.json\", \"data/responses.json\", and\r\n each of their variants to relieve some storage space (the program will not\r\n execute any other commands when this flag is set)\r\n```\r\n\r\n\r\n\r\n## Example Console Output\r\n```\r\n$ python wordle_autosolver --auto wordle --num 4 --start lucky words\r\nLoading precalculated data...\r\nFinished loading.\r\n\r\nConnecting to the target website...\r\nConnected to 'https://www.quordle.com/#/'\r\n\r\nStarting solver. Simulating 4 simultaneous Wordle games.\r\n\r\nSuggested starting word is SALON\r\n\r\n\r\nSolved 0/4 boards: [*****, *****, *****, *****]\r\n\r\n Predetermined guess is LUCKY\r\n\r\n Response was \".....\" on board 1\r\n Best guess(es) on board 1: SANER\r\n 1576 possible answers\r\n Response was \".....\" on board 2\r\n Best guess(es) on board 2: SANER\r\n 1576 possible answers\r\n Response was \"..+..\" on board 3\r\n Best guess(es) on board 3: SHORE\r\n 309 possible answers\r\n Response was \".O...\" on board 4\r\n Best guess(es) on board 4: TERMS, TREMS\r\n 149 possible answers\r\n\r\nSolved 0/4 boards: [*****, *****, *****, *U***]\r\n\r\n Predetermined guess is WORDS\r\n\r\n Response was \"+...+\" on board 1\r\n Best guess(es) on board 1: POINT, MEANT, PHASE, SHAPE, PRINT, SAINT, SPITE, PAINT, ...\r\n 18 possible answers\r\n Response was \".O..+\" on board 2\r\n Best guess(es) on board 2: MEDIA, EMAIL, MERIT, FISTS, THINE, MAIZE, MISTY, AMINE, ...\r\n 18 possible answers\r\n Response was \"...O.\" on board 3\r\n\r\n The answer on board 3 is CHIDE\r\n\r\n Response was \"....O\" on board 4\r\n Best guess(es) on board 4: PETIT, BATHE, INEPT, MOTEN, PATEN, PETTI, MEINT\r\n 34 possible answers\r\n\r\nSolved 1/4 boards: [*****, *O***, CHIDE, *U**S]\r\n\r\n Guessing CHIDE...\r\n\r\n Response was \"....+\" on board 1\r\n Best guess(es) on board 1: SWEEP\r\n 4 possible answers: SWEET, SWEPT, SWEAT, SWEEP\r\n Response was \"....O\" on board 2\r\n Best guess(es) on board 2: AMONG, ALONG, WRONG, SIGNS, GROWN, SONGS, MASON, AGONY, ...\r\n 4 possible answers: GOOSE, MOOSE, NOOSE, POSSE\r\n Response was \"....+\" on board 4\r\n Best guess(es) on board 4: THUMB, TOMBS, AMBIT, TIMBO\r\n 10 possible answers\r\n\r\nSolved 1/4 boards: [SWE**, *O*SE, CHIDE, *U**S]\r\n\r\n Guessing AMBIT...\r\n\r\n Response was \".....\" on board 1\r\n\r\n The answer on board 1 is SWEEP\r\n\r\n Response was \".+...\" on board 2\r\n\r\n The answer on board 2 is MOOSE\r\n\r\n Response was \".....\" on board 4\r\n Best guess(es) on board 4: GUESS, FUSES\r\n 2 possible answers: GUESS, FUSES\r\n\r\nSolved 3/4 boards: [SWEEP, MOOSE, CHIDE, *U**S]\r\n\r\n Guessing SWEEP...\r\n\r\n Response was \"+.O..\" on board 4\r\n\r\n The answer on board 4 is GUESS\r\n\r\n\r\nSolve complete.\r\n\r\nEntering all remaining answers... (2 total)\r\n Entered 1/4 SWEEP\r\n Entering 2/4 MOOSE\r\n Entered 3/4 CHIDE\r\n Entering 4/4 GUESS\r\nSaving all newly discovered data...\r\nSave complete.\r\nPRESS ENTER TO EXIT\r\n```\r\n\r\n\r\n",
"bugtrack_url": null,
"license": "GPL-3.0",
"summary": "A Wordle solver that can generate near-optimal decision trees and automatically play on multiple different websites including Quordle, Fibble, and Wordzy Master",
"version": "0.7.4",
"split_keywords": [
"wordle",
"solve",
"solver",
"optimize",
"optimal",
"best",
"website",
"automate",
"selenium",
"chromedriver",
"dordle",
"quordle",
"octordle",
"duotrigordle",
"fibble",
"wordzy"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5de5258f70023938b7499e53b21e64dc0bddaeacd581aed9f7e86dba90d76f6b",
"md5": "cbe1e13fee0c69357dc27b1d5157975e",
"sha256": "b8c8cdc17b4e7b79c3b934d76b845f5b581e5ef5d5a99b5085309cfc54d05e58"
},
"downloads": -1,
"filename": "wordle_autosolver-0.7.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cbe1e13fee0c69357dc27b1d5157975e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 223009,
"upload_time": "2023-02-08T09:00:22",
"upload_time_iso_8601": "2023-02-08T09:00:22.576904Z",
"url": "https://files.pythonhosted.org/packages/5d/e5/258f70023938b7499e53b21e64dc0bddaeacd581aed9f7e86dba90d76f6b/wordle_autosolver-0.7.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5629a42243a6c60b1406bd9c03410f65988f0766d987a7a20566167d02c8400f",
"md5": "84bed6ce9c6e52cf9f3165c576044cb2",
"sha256": "46e66664b89b593ab7bb6ec485a0c1483c2e5bfdfab62dfc2796d8780c1c832c"
},
"downloads": -1,
"filename": "wordle_autosolver-0.7.4.tar.gz",
"has_sig": false,
"md5_digest": "84bed6ce9c6e52cf9f3165c576044cb2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 226418,
"upload_time": "2023-02-08T09:00:24",
"upload_time_iso_8601": "2023-02-08T09:00:24.022561Z",
"url": "https://files.pythonhosted.org/packages/56/29/a42243a6c60b1406bd9c03410f65988f0766d987a7a20566167d02c8400f/wordle_autosolver-0.7.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-02-08 09:00:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "pueblak",
"github_project": "wordle-autosolver",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"tox": true,
"lcname": "wordle-autosolver"
}
JSON
