https://github.com/nexxeln/wordle-solver

An interactive terminal interface to solve wordle
https://github.com/nexxeln/wordle-solver

puzzle-solver python rich wordle wordle-python wordle-solver

Last synced: 5 months ago
JSON representation

An interactive terminal interface to solve wordle

• Host: GitHub
• URL: https://github.com/nexxeln/wordle-solver
• Owner: nexxeln
• License: mit
• Created: 2022-03-02T12:01:42.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2022-05-27T12:31:10.000Z (over 3 years ago)
• Last Synced: 2025-03-30T22:32:34.137Z (6 months ago)
• Topics: puzzle-solver, python, rich, wordle, wordle-python, wordle-solver
• Language: Python
• Homepage:
• Size: 7.05 MB
• Stars: 21
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
Wordle Solver


![demo gif](https://github.com/nexxeln/wordle-solver/blob/main/images/wordle-solver-demo.gif?raw=true)

## Overview

This is yet another wordle solver. It is built with the word list of the official [wordle](https://www.nytimes.com/games/wordle/index.html) website, but it should also work with most wordle websites. The algorithm is quite efficient, but it is not perfect. On playing 50 games of wordle using the solver, the average number of tries it took to guess the word is **3.86**.

## Prerequisites

- [Python 3.6](https://python.org) or later

## Installation

- Clone the repository: `https://github.com/nexxeln/wordle-solver`

- Create a new virtual environment: `python -m venv venv`

- Activate the virtual environment 


  - Windows: `venv/Scripts/activate`

  - Linux: `venv/bin/activate`

  - MacOS: `venv/bin/activate`

- Install the dependencies: `pip install -r requirements.txt`

## Usage

- Go to the [wordle](https://www.nytimes.com/games/wordle/index.html) website

- Run the program: `python wordle.py`

  - The solver will provide you the words to guess

  - To input the colours the convention is:

    - `x` for gray/black (letter is not in the word)

    - `y` for yellow (letter is in the word but in the wrong position)

    - `g` for greeen

  - Enter the words provided in the wordle website

  - You can also see the demo gif above

- Flex your wordle skills and share it with your friends

## Contributing

Contributions are welcome! This algorithm can definitely be even more optimized.