wordle

A Python script and a Jupyter notebook that imitate wordle!

If you're not familiar with it, wordle is basically a "guess the word" game. You have 6 tries to attempt to guess a letter word. For each guess, it will give feedback in the form of colored tiles indicating when letters match or occupy the correct position:

• Green for when you get the letter on the right position
• Yellow for when the letter is in the word but in another position
• Gray if the letter is not in the word.

How to play

In this repo, you will find a very simple prototype of the game in the Jupyter notebook called wordle.ipynb, and in the Python file called wordle.py. I suggest you try playing it on VS Code, either on the web (no local installs required!) or the Desktop. You will find the set up steps below.

Play it in the Jupyter Notebook 📒

🌐 Web set up

To play it on the web, simply open this repo in vscode.dev, or just press "." if you're reading this on GitHub to open it in github.dev.

Open the Extensions view (Ctrl + Shift + X or Cmd + Shift + X) and install the "vscode-pyodide" extension published by "joyceerhl".

🖥️ Desktop set up

Download VS Code and install the following extensions:

• Python
• Jupyter Notebooks

Then open this repo in VS Code, and open the wordle.ipynb file.

If you don't have Python installed, you can follow the steps here. When you try to run the first cell in the notebook, you will be able to follow some set up steps to get your environment ready to use the notebook features.

🎯 Placing your guess

Once you're able to run the first cell, you can place your first guess by creating a new cell (Ctrl + Enter or ⌘ + Enter) and calling the guess_word function and passing a string with your first word to it. For example, you can try guess_word("ghost").

For each guess you make, you will get:

• _ when the letter isn't in the answer
• The letter between () if it is in the answer word but in a different position
• The letter itself when you get it in the right position.

If you get the word right with 6 or less guesses, you win the game. If you don't, you lose.

To play again, simply re-run the first cell and it will reset the turns and pick a different word for you.

Play it in the Python file 📜

🌐 Web set up

To play it on the web, navigate to https://vscode.dev/github/luabud/wordle?vscode-coi=

Open the Extensions view (Ctrl + Shift + X or Cmd + Shift + X) and install the "ms-vscode.vscode-python-web-wasm" extension publised by Microsoft.

🖥️ Desktop set up

Download VS Code and install the Python extension.

Then open this repo in VS Code, and open the wordle.py file.

If you don't have Python installed, you can follow the steps here.

🎯 Placing your guess

Click on the run button on the top-right of the editor, or open the Command Pallete ((Ctrl + Shift + P or Cmd + Shift + P)) and run the Python: Run Python File command.

You'll be prompted to enter a guess with 5 letters.

For each guess you make, you will get:

• _ when the letter isn't in the answer
• The letter between () if it is in the answer word but in a different position
• The letter itself when you get it in the right position.

If you get the word right with 6 or less guesses, you win the game. If you don't, you lose.