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

A very simple web app to solve wordle.
https://github.com/jamesread/wordle-solver

cli-tool maturity-prod wordle

Last synced: 21 days ago
JSON representation

A very simple web app to solve wordle.

• Host: GitHub
• URL: https://github.com/jamesread/wordle-solver
• Owner: jamesread
• License: agpl-3.0
• Created: 2022-01-13T09:51:53.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2025-07-03T22:16:56.000Z (12 months ago)
• Last Synced: 2025-10-13T14:24:37.693Z (9 months ago)
• Topics: cli-tool, maturity-prod, wordle
• Language: Python
• Homepage:
• Size: 209 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          


	
wordle-solver

	
Crush wordle with just filtering logic.


[![Maturity](https://img.shields.io/badge/maturity-Production-brightgreen)](#none)

[![Build Tag](https://github.com/jamesread/Sicroc/actions/workflows/build-tag.yml/badge.svg)](https://github.com/jamesread/Sicroc/actions/workflows/build-tag.yml)

[![Discord](https://img.shields.io/discord/846737624960860180?label=Discord%20Server)](https://discord.gg/jhYWWpNJ3v)



A very simple web app to solve wordle - it suggests a ranking of the best possible next guesses that statistically is most likely to win the game in as few moves as possible.

The ranking of words is determined by an algorithm that is mostly just using constraint-based filtering of the English dictionary, based on the results of guesses, coupled with the frequency statistics of probable words.

![screenshot](screenshot.png)

This app has a solve rate within the very high 90% - probably 98%, and most of the time loss is simply down to human input error or occasionally words not existing in the dictionary, otherwise, it generally destroys, I mean, solves, wordle, very nicely :)

* [Wordle - Original game](https://www.nytimes.com/games/wordle/index.html) 

* [Wordly - allows infinate plays](https://wordly.org/)

## Interesting game variations 

* [Octordle - Paralell 8 way](https://www.britannica.com/games/octordle/)

* [Victordle - Multipler supposedly, but feels like bots](https://www.britannica.com/games/victordle/), this app scores on average 81% win over 50 games (the 20% "loss" is that sometimes the opponent guesses correctly first!)

## Installation (docker container)

This is by far the easiest way to run the app, simply run the container like this;

	docker run --name wordle-solver -p 8080:8080 ghcr.io/jamesread/wordle-solver

## Installation (local)

Pip install the dependencies;

    pip install enwords

    pip install wordfreq

### Run

    ./wordle-solver.py